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VAC oDK a available for | 
RASPBERRY PI! 


With VNC SDK you can connect VNC Viewers with VNC Servers } 
easily over the Internet. Using VNC Cloud, no complicated 
network configuration at either end is required! 


What will you create with VNC SDK? 


Check it out here: https://developer.realvnc.com/ 


Getting connected: www.realvnc.com/products/vnc/raspberrypi/ 
For more information contact vncdeveloper@realvnc.com 


WELCOME TO 
THE OFFICIAL 
PI] MAGAZINE! 


hen the Raspberry Pi Zero launched towards 

the end of last year, it turned the world of tiny 
computers on its head. Cheap enough to be 
given away on the cover of this very magazine, yet more 
powerful than the original Raspberry Pi, the Zero took 
off quicker than Tim Peake’s rocket. While we’ve all 
been busy making consoles out of games controllers and 
robots out of matchboxes (seriously!), there’s always 


been one type of project that’s been sorely unavailable SUBSCRIBE & = ~ —i_ 2 ee 


— anything using the Raspberry Pi Camera Module. ll a saasPoenny 
Amazingly, that’s no longer an issue: the Pi Zero 1.3 is SEE PAGE 34 FOR DETAILS = = An 


here and it comes complete with a specially designed 
camera connector that works with both the old and new 
Camera Modules. Learn more about it on pages 6 and 7, 
or better yet, subscribe to the magazine for six or 12 THIS MONTH: 
months to get one sent to you completely FREE (see 
pages 34 and 35 for details). 

Of course, you can’t get very far with your Raspberry 
Pi projects without being able to control the General 
Purpose Input/Output (GPIO) pins. If you’d like to get 18 ELECTRONICS FOR BEGINNERS 


stuck in, but don’t know where to start, look no further 
than this month’s cover feature starting on page 18. 


Electronics with the Raspberry Pi couldn’ t be easier! 36 AMAZING PROJECTS SHOWCASED 


Another four incredible Pi-powered creations under the spotlight 


6 PI ZERO 1.3 IS HERE — SAY CHEESE! 


There's a new Pi Zero and it comes with a camera connector 


Make use of those devilishly useful GPIO pins with our help 


Russell Barnes 
Managing Editor 72 RASPBERRY PI WEATHER STATION 


Learn how to put together this incredible Oracle-powered kit 
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COVER FEATURE 
> RECORD TEMPERATURES 46 


Measure and chart temperatures with the Sense HAT 


> ASTEROIDS IN BASIC (PT2) 48 


Put the finishing touches to this classic game 


> MAKE A BUILD STATUS LIGHT 52 


Get the green light with this Jenkins-powered project 


> SCIENCE WITH THE SENSE HAT 54 


Measure gravity using the Pi's amazing sensor board 


> MASTER THE COMMAND LINE 56 


Learn how to manage processes and more 


> BUILD A NIGHT-VISION CAMERA 58 18, 


Do it in easy steps with our expert advice 


> MIKE'S PI BAKERY: SPECTRUM 60 


ht PI] ELECTRONICS 


> MAKE AN IOT WEIGHT SCALE 66 


hii Sey che ecct a Stop ale THGaG Get to grips with basic electronics projects on your Raspberry Pi 


> HACK AN RC REMOTE CONTROL 70 
Control a Lego car with a Raspberry Pi Zero! Ra S pb l an) 


There's another new build of 
Raspbian available. Learn all 
about it on pages 8-9 


Pi Zero 1.3 arrives 


There's a brand new Pi Zero that lets you build even 
more amazing camera projects with Pi 
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THE BIG FEATURE 


THE PI WEATHER STATION 


Learn how to set up and use the amazing Oracle-powered Raspberry et out eheitients watch 


rising sea levels with the aid of the Pi 


REGULARS 


Pi weather station, and get a few ideas for what to do with it 


YOUR PROJECTS 


> NEWS 06 
The biggest stories from the world of Raspberry Pi 

> TECHNICAL FAQ 78 
Got a problem? Maybe we can help... 

> BOOK REVIEWS 86 
The best reads for coders and hackers 

> THE FINAL WORD 96 


More musings from Raspberry Pis own Matt Richardson 


COMMUNITY 


> THIS MONTH IN PI 88 
FISH- EYE Find out what else has been happening in the community 
There's something decidedly fishy about Thomas Hudson's computer monitor 
> EVENTS 90 
Get involved in a community gathering near you! 
Pi Coffee Roaster 38 > YOUR LETTERS 92 


Make an even better cup of Joe with 
this Pi-powered coffee roaster 


Talk to us about the magazine (or anything you like!) 
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A computer that plays Connect 4? Nothing 
a bit of maths and code can't handle.. 
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Meet the MagPi reader who's built a very > ROBOHAT 83 
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PI ZERO 
VISION 


The Pi Zero is back in production and now comes with a camera connector 


To celebrate the launch of the new Pi Zero on 

16 May, Dave Akerman launched one of them 

- with Camera Module attached - in a high- 
altitude balloon. As it soared from a Herefordshire 
field to the edge of space at an altitude of over 
34km, some spectacular shots were captured 
(magpi.cc/1XeuQCo). 


Through “dumb luck", it was discovered that 

the same fine-pitch FPC connector used on the 
Compute Module IO Board just fits onto the right- 
hand edge of the Pi Zero board. Instead of using 
the Compute Module's optional PCB adapter to 


connect to a Camera Module, however, a flexible 
custom cable has been designed. As well as being 
sleeker and more practical for miniature projects, 
it's less costly at £4/$5. Like the new Zero itself, the 
cable is available now from the usual Pi retailers. 
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or anyone trying to get 

their hands on a Raspberry 

Pi Zero, there’s doubly 
good news. Not only is the smallest 
Pi model back in stock, due toa 
new production run of 250,000 
units, but it comes with an extra 
feature: a new port to connect the 
Raspberry Pi Camera Module. This 
opens up a whole range of new 
possibilities for miniature projects 
using a camera. 

To fit the diminutive form factor 
of the Zero, the camera port is 
Slightly smaller than the CSI one 
on other Raspberry Pi models. 
Therefore, a special adapter cable 
is required to connect it to the 
wider connector on the standard 
Raspberry Pi Camera Module 
(including the NoIR). The new 
custom cable is flexible, 15cm 


(6 inches) long, and costs £4/S5 — 
the same price as the Zero itself. 
While stressing that this isa 
revised version of the Pi Zero and 
not a brand new model, since 
the rest of the board is unchanged, 
Raspberry Pi founder Eben Upton 
is pleased that a recent hiatus in 
the production for the miniature 
model, during the run-up to the 
Pi 3 launch in February, enabled 
the team to add the new camera 
connector. Asked whether this 
was something they wanted to 
include originally, Eben admits: 
“No... It’s a thing we didn’t think 
we could add.” More recently, 
however, following feedback from 
users requesting the feature, they 
realised they could fit a small 
camera connector to the right- 
hand edge of the board. 
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The rest of the board is 
unchanged, so has the same 
specs as the original Zero 


Meeting demand 

Eben tells us that they were taken 
aback by the huge demand for the 
Pi Zero, following its launch last 
November. “It’s one of the things 
with Raspberry Pi: on some level, 
we’ re always surprised.” He tells us 
that they take a cautious approach 
to production numbers: “TI have 


39993395 
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You can connect upa 
standard Camera Module (or 
NoIR) and itll work as normal 
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Extra caution was required in 
the case of the Pi Zero, since its 
production is handled in-house, 
unlike other Raspberry Pi models 
whose manufacture is licensed to 
distributors RS Components and 
CPC/Farnell. While Eben insists that 
this licensing model “is and always 
will be the heart of the business”, 


They were taken aback by the 
huge demand for the Pi Zero 


this nightmare that the one time | 
actually build a load, speculatively, 
Pll find that it’s the one product 
that people don’t like.” He reveals 
that the original Model A didn’t 

sell that well, since most users 
preferred the Model B, which had 
more features and was only slightly 
more expensive. Eben says if they’d 
ramped up production for the 
Model A at the time, “That really 
would have sunk us. So I think it’s 
always better to be cautious.” 
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the Zero is not a natural fit for it due 
to not being a high-margin product. 
Now knowing that the Pi Zero is 
in such great demand has enabled 
Eben to confidently order an initial 
production run of 250,000. “We’re 
launching with 30-40,000 units... 
We’re going to push the rest of that 
stock through quite quickly.” He 
reckons an annual production figure 
of “about a million” is achievable, 
which means that there should now 
be enough Zeros to meet demand. 


Anew flexible adapter cable 
has been created to link the 
Zero to the Camera Module 


The new camera 
connector is smaller 
than the CSI port 

on other Pi models 


Eben has been delighted by the wide range of 
projects created so far using the Pi Zero. “It’s been 
weird seeing how prevalent it's been,” considering 
that the Zero represents only a small fraction of 
total Pi sales. “The small form factor [and self- 
contained naturel] obviously enables a lot of stuff... 
build it into a mouse, build it into a joystick/ 

game controller.” With the camera connector now 
offering even more possibilities, we can't wait 

to see what users create with the new Zero. 
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DOWNLOAD 2g Seam CTR E eo @ £0 a= 
THE LATEST 
VERSION OF 
RASPBIAN 


NOW! 
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Above A slightly 
tweaked interface 
and some 

new software 

for Raspbian 


The latest version of Raspbian has some great additions, such 
as improved Bluetooth support and an internal backup tool 


aspbian, the official its initial release, the Bluetooth you can make the Raspberry Pi 

Raspberry Pi operating support was a little barebones. discoverable to other Bluetooth 

system, is always in It was easy to upgrade using devices or add a Bluetooth device. 
development. There’s always something like Blueman to adda The ‘Add New Device’ window 
something new coming, witha eraphical interface, though. Inthis — will fill up with local Bluetooth 
desired features list a mile long release, Simon has addedacustom devices which you can then pair 
that Raspbian crafter Simon Long Bluetooth interface. with. Right now, there’s only full 
works with to try to improve your “Td hoped to be able to use one support for keyboards, mice, and 
Raspberry Pi experience. Recently, — of the existing Linux Bluetooth audio devices. Bluetooth audio now 
a big update to the operating UIs,” Simon explains inthe release works slightly better than before, 
system was released with anumber blog. “[After] trying them all, none due to the inclusion of PulseAudio 
of additions and changes that were really what I was looking tools. If you recall from a tutorial 
crossed off some of these features, for in terms of usability and back in issue 44, you needed to 
while addressing support for integration with the look and feel install the latter to get the audio 
recent hardware updates. of the desktop. I really didn’t want output working. 

to write one from scratch, but that 

Improving Bluetooth was eventually what I did.” SD card backup 
While support was added for The interface is quite A common question in the Pi 
the Bluetooth and Wireless LAN straightforward: by clicking on community is how to back up the 
chip of the Raspberry Pi 3 during the Bluetooth icon in the taskbar, SD card. There are several existing 


8 | MdgPi June 2016 raspberrypi.org/magpi 


16 


Geany also works with Python and may be preferable to IDLE for some people 


methods, although none of them 
are native to Raspbian. A new tool 
has now been added that allows 
you to copy the SD card while the 
Raspberry Pi is running. 

The SD Card Copier requires 
you to have a USB card reader 
for it to work. It’s fairly simple: 
you just need to plug an SD card 
into the reader, plug the reader 
into the Raspberry Pi, and tell the 
SD Card Copier to copy the data 
to that card. 

“The program doesn’t restrict 
you to only copying to a card the 
Same size as the source,” Simon 
mentions. “You can copy toa 
larger card if you’re running out of 
Space on your existing one, or even 
to a smaller card (as long as it has 
enough space to store all your 
files - the program will warn you 
if there isn’t enough space).” 


Programming tools 
The new version of Raspbian also 
comes with a new GPIO library, 
pigpio, which provides two benefits. 
First, it unifies access to the GPIO 
pins from Python, C, and other 
languages. Secondly, as a result 
of this, you won’t need to sudo 
programs that use the GPIO pins. 
This includes Scratch. 

The popular text editor/light 
IDE Geany has also been added to 
Raspbian. It allows for programming 
in multiple languages; if you’re more 
of a seasoned coder, you might get 
on better with this than some of the 
other tools included in Raspbian. 

There’s your usual series of minor 
application updates and UI tweaks, 
as well. It’s a great update and you 
can read up on the full rundown 
of changes on the release blog: 
Magpli.cc/1Va2ael 


There are two main ways you can get the new update. The quickest 
way, if you're already running a copy of Raspbian Jessie, is to open the 
terminal and use the following commands: 


sudo apt-get update 
sudo apt-get dist-upgrade 


sudo apt-get install piclone geany usb-modeswitch pi-bluetooth 
sudo apt-get install python-pigpio python3-pigpio 


You can also reinstall Raspbian to the card. If you have the time 
and can easily transfer anything you're working on with it, then we 
recommend doing this. Find instructions here: magpi.cc/1MYYTMo 
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Transfer files to USB 

Avery quick and simple way to perform a backup 
is literally just to make a copy of any important 
files to a USB stick plugged into the Pi. This won't 
remember any settings or extra software you have 
installed, though. 


Transfer files to computer 

Similar to USB; turn off your Raspberry Pi and 

plug your SD card into another computer. From 
there, you can copy the files onto the other system 
without much trouble, as well as more easily being 
able to copy any settings or profile files. 


Card copy 

In the same way you can write an image to an 

SD card, you can do the reverse and copy an SD 
card to create an image. This is similar to the SD 
Card Copier utility. However, you can save it to 
anywhere on your computer, which likely has more 
space than a USB stick. 
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FLOODING 


Cornish students watch rising sea levels sink their school 
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using a Raspberry Pi supercomputer 


ornish students spent 

the day modelling climate 

change on a Raspberry Pi 
Supercomputer at their annual 


The University of Exeter event 
enabled students to learn Big 
Geo Data processing methods. 
Students used Grappolo, a cluster 
computer built by Spatial Ecology 
(spatial-ecology.net) to model 
rising sea levels. 

“This passionate community 
of young future scientists met 
researchers and took part 
in arange of activities and 
workshops,” says Dr Andrew 
Cowley, computing development 
officer at the University of Exeter. 
“The aim was to identify the 
single greatest challenge the 
local environment faces.” 


Multiple Raspberry Pis are linked 
together to create a cluster. It runs 
the same software as a true high- 
performance supercomputer 


Students used Grappolo (magpi.cc/1TUNHxi), 

a supercomputer cluster made from three 
Raspberry Pi 2s. Grappolo is used to teach cluster 
computing using a grid engine. The micro cluster 
computer replicates the functioning of the 
biggest cluster computer facility in South West 
England. Grappolo is similar to a Raspberry Pi 
cluster developed at Southampton University, but 
aimed towards teaching big data processing for 
geographic information systems methods (rather 
than raw computation). It costs around £140 to 
build and is a portable and perfect replica of 

an operating system running on an actual high- 
performance cluster computer. 
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Environment & Sustainability Day. 


Andrew ran the Flooding Risk 
Workshop along with Dr Stefano 
Casalegno, associate research 
fellow at the University of Exeter. 

“We investigated probability 
and risk,” says Andrew, “and 
modelled impacts of sea level rise 
under climate change scenarios 
using the open-source software 
QGIS (a geographic information 
system). Students used Grappolo 
and OGIS software to model 
how much sea levels would 
have to rise before their school 
becomes submerged.” 

The Raspberry Pi cluster 
“simulates the functions of the 
biggest cluster computer facility 
in the South West,” says Andrew. 
“Grappolo is similar to another 
Raspberry Pi cluster developed 
at Southampton University, but 


ne 
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Cornish students modelled the impact of sea 


level rise under climate change scenarios 


is aimed towards teaching and 
demonstrating ‘big geo data’ 
processing methods rather than 
raw computation. 

“Within the workshops, 
students visualised impacts 
of global sea-level rise using a 
1km resolution digital elevation 
model (DEM) derived from 
the NASA’s Shuttle Radar 
Topography Mission (SRTM).” 

SRTM data was captured 
by the Space Shuttle Endeavour 
in 2000, and released globally 
in 2014. The radar data was used 
to create the first near-global 
set of land elevations and is now 
available from the US Geological 
Survey website (magpi.cc/1TEyE]]j). 

“The public availability of 
enhanced global SRTM topographic 
data will greatly benefit 
international efforts to understand 
better natural processes that shape 
our planet, prepare for and respond 
to natural hazards, and anticipate 
and prepare for the impacts of 
global change,” commented 
NASA chief scientist Ellen Stofan. 
“NASA is proud to have played a 
critical role in creating these data 
that will benefit society through 
open data sharing.” 

Using a small, Raspberry Pi- 
powered supercomputer to crunch 
NASA data sounds cool, but it was 
locally sourced data that captured 
the students’ imagination. “What 
pupils enjoyed most,” says 
Andrew, “was the use of a local 
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digital elevation model (DEM) 
from the Tellus project 
[www.tellusgb.ac.uk].” 

Tellus South West is a project 
funded by the Natural Environment 
Research Council (NERC). They 
used an airborne lidar survey to 
create maps and data. According 
to Tellus: “The maps and data 
produced show the soils, rocks, 
landscape, and ecology of Devon 
and Cornwall in unprecedented 
depth and detail, and augment 
existing data to provide the 
two counties with among the 
best and most comprehensive 
environmental datasets anywhere 
in the world.” 

This incredibly accurate data 
of the surrounding area enabled 
students from Cornwall to simulate 
sea-level rise in Cornwall, to flood 
their schools and other places 
familiar to them. 

“The most rewarding part of 
the day for Stefano and for me 
was showing the students about 
the Raspberry Pi, Linux, and FOSS 
doing great things together,” 
Andrew tells us. “It was also 
ereat that so many of them asked 
further questions about the Pi, 
the Grappolo, high-performance 
computing, and also environmental 
issues facing Cornwall.” 

Students elected the Flooding 
Risk workshops, run by Andrew 
and Stefano, as the winner of the 
Environment & Sustainability 
Day event. 
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Students used two sets of data in the Flooding 
Risk workshop. 

The first is data collected from NASA's Shuttle 
Radar Topography Mission (magpi.cc/1Yqd3aL). 
SRTM flew aboard the Space Shuttle Endeavour 
in February 2000, mapping Earth's topography 
between 56 degrees south and 60 degrees north 
of the equator. During the 11-day mission, SRTM 
used an imaging radar to map the surface of Earth 
numerous times from different perspectives. 

Local data of Cornwall from the Tellus Project 
(tellusgb.ac.uk) was also used. This local 


geophysical survey measured traces of natural 


magnetism and radioactivity to make maps of the 
properties of the rocks, soils, and fluids under the 
skin of the Earth. 


Shot adit: Matt Jessop 


The Grappolo is a small Raspberry Pi supercomputer used 
to teach cluster computing using a grid engine 
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The Astro Pi units 
have been gathering 
data aboard the ISS 
and have returned 
their sensor readings 
to Earth 
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RESULTS ARE IN 


Get your hands on the sensor data collected from the Astro Pis on 
the ISS and apply for a special schools conference with Principia 
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ata from the two Astro Pi 

units, orbiting the Earth 

aboard the ISS (International 
Space Station), is now publicly 
available. These special Raspberry 
Pis, nicknamed Ed and Izzy, blasted 
into space along with UK astronaut 
Tim Peake in December 2015. 

Part of their payload contained 
seven winning programs, created 
by school-age students. After 
these student experiments had 
completed, the Astro Pis set about 
a long-term ISS environmental 
monitoring program. 


This mission has produced 
data files chock-full of ISS sensor 
readings. These files have now 
been made available to the public, 
allowing budding scientists to 
analyse the data collected. 

Ed and Izzy have returned the 
captured data to Earth, in the 
form of CSV (comma-separated 
value) files. The data is ready for 
download and analysis by the 
Raspberry Pi community. 

The sensor readings can 
be downloaded directly from 
the Raspberry Pi website; 


the data is included in the 

Flight Data Learning Resource 
(magpi.cc/1ZNxUVE). This 
resource walks students through 
the sensor readings and helps 
them understand the data. 

Jamie Bailey, CEO and founder 
of Initial State, has already taken 
the Astro Pi data and placed it 
into a web visualisation. “We took 
the CSV data collected from the 
ISS, uploaded it to Initial State’s 
tools, and shared each dataset 
publicly for anyone to use,” says 
James. “You can also bring data 
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into Initial State’s data analytics 
tools through file uploads. The data 
delivered from the ISS is in CSV, 
a supported file format.” 

You can view the Astro Pi 
data visualisation in your 


®-0,000808 “0.000255 


Raspberry Pis that have been 
collecting sensor measurements 
aboard the ISS. 

Dave Honess, the education 
resource engineer in charge 
of the Astro Pi project, will 


Ed and Izzy have returned 
the captured data to Earth, 
in the form of CSV files 


browser on the Initial State blog 
(magpi.cc/1ZNyoMY). 


Holding an Astro Pi 

To celebrate Tim Peake’s return 
from his mission aboard the ISS, 
the UK Space Agency is inviting 
young adults to attend two special 
Principia School Conference events 
in November (magpi.cc/25b6eRD 
and magpi.cc/25b63WE). 
Attendees will also be able to view 
some flight-equivalent Astro Pi 
units. These are the same devices 
as Ed and Izzy, the augmented 
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be at both conferences with a 
selection of the incredibly rare 
Raspberry Pi devices. Only eight 
flight-equivalent Astro Pis were 
ever made, constructed from 
aerospace-grade aluminium, and 
two of these went on to become Ed 
and Izzy aboard the ISS. “They’re 
kind of like holy artefacts to 
Raspberry Pi fans,” says Dave. 
Students presenting at the 
Principia School Conference will 
be able to use the flight-equivalent 
Astro Pi devices as part of 
their presentation. 
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ASTRO PI DATA DOWNLOAD 


Data from Ed and Izzy, the Astro Pi units aboard the 
ISS, can now be downloaded in the standard CSV 
(comma-separated value) format. Three separate 
files are available. 

The first two sensor readings were collected in 
the Columbus Module, and the third in the Node 2/ 
Unity module. 


Unit Location on ISS Length 


Astro Pi Vis (Ed) Columbus 2 weeks 


Astro Pi Vis (Ed) Columbus 4 weeks 


Astro Pi IR (Izzy) Node2 2 weeks 
You can download the data directly from the 
Astro Pi Flight Data Analysis worksheet on the 
Raspberry Pi website (magpi.cc/1ZNxUVE). 

This sheet also explains how to understand 

and use the data. 

You can work directly with the data, using Python 
or a program like Mathematica or MATLAB (both of 
which are free on the Raspberry Pi). 

If you don't want to produce your own graphs, 
then James Bailey from Initial State has already 
created some visualisations that you can view 
online. See Jamie's blog at Initial State for more 
information (magpi.cc/1ZNyoMY). 
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Tim's mission aboard the ISS has 
been extended by two weeks, giving 
him more time with Ed and Izzy 


Tim has inspired UK schoolchildren 
with his mission aboard the ISS 


MagPi June 2016 


“This conference isn’t just for 
the winners of the various Principia 
competitions: it’s for anyone 
who’s been affected by Tim’s 
mission. I bet there are some really 
interesting stories out there,” says 
Dave. “It’s going to be brilliant!” 

The Principia Schools Conference 
gives students the chance to 
demonstrate a science project to 
a panel of space experts, possibly 
including Tim himself. 


Welcome home, Tim 

Tim has received a two-week 
extension to his stay aboard the 
ISS. The ESA (European Space 
Agency) has decided to keep the 
ISS operating at full capacity with 
Six astronauts. 

He is now due to land in 
the steppe of Kazakhstan 
on 18 June with two fellow 
astronauts. Tim will return to the 
European Astronaut Centre in 
Cologne, Germany, for check-ups 
and research into how humans 
adapt to living in space. 

His schedule when he returns to 
Earth will be extremely busy, but 
Tim hopes to be at the Principia 
School events and wants to 
meet people at the conferences. 
Everybody is working hard 
to achieve this goal. 

Tim has mixed thoughts about 
returning: “Although I am looking 
forward to being back on Earth and 
seeing friends and family again, 
each day spent living in space is a 
huge privilege and there is much 
work to do on the Station. 

“This extension will keep 
the Station at a full crew of 
six for several days longer, 
enabling us to accomplish more 
scientific research. 

“And, of course, I get to enjoy 
the beautiful view of planet Earth 
for a little while longer!” 

Each crew member flies as a 
trio to the ISS and back in a Soyuz 
spacecraft. About every three 
months, a crew returns to Earth 
shortly before a new one arrives, 
often leaving a few days when 
only three astronauts look after 
the Station. 
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Izzy, our Astro Pi unit with an IR sensor, 
is attached to a window of the ISS 


Joining the Conference 
The Principia School Conference 
events will take place in November 
2016, at universities in York and 
Portsmouth. Attendance at each 
event is free, and the UK Space 
Agency will offer travel bursaries 
to help with the cost of attending. 
Places are limited and potential 
attendees will need to submit an 
application. “The judging panel 
would love to see reports of things 
such as scientific experiments, art 
projects, whole school projects, 
special events, and community 
outreach,” explains the Principia 


AstroPi tr 


Fb 


It would be great to see a 
strong Astro Pi contingent at 
both conferences, so we strongly 
encourage anyone who engaged 
with Astro Pi to apply. The deadline 
for applications is Thursday 
15 September 2016 at 12 noon. 
See the box on the right for details 
on how to get started. 
Applications to the conferences 
are not limited to previous 
winners of Principia or Astro Pi 
competitions, so anybody can 
enter. The UK Space Agency 
wants your entry to tell the story 
of your project, describe what 


It would be great to see a 
strong Astro P1 contingent 


website. “The applications should 
communicate what work has 

been done, what was learnt by 
doing the work, and why this 
should be shared with an audience 
at the conferences.” 

The Principia mission has a 
tremendous range of educational 
activities linked to it, one of which 
is the Astro Pi. The conferences 
will be attended by students from 
across all of the Principia missions. 

There are up to 500 places 
available at both of the conferences; 
the teams and individuals who 
present the strongest applications 
will be invited to take part. 
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you’ve learned, and what long- 
term effects the work has had 
on your school. 

To illustrate the kind of 
applications Principia is hoping 
to see, it’s worth mentioning the 
Astro Pi testimonial that maths 
teacher Gillian Greig, from The 
Priory School in Hitchin, wrote last 
year (magpi.cc/1ZNxNcT). Gillian’s 
testimonial is a great example of 
the kind of story the organisers 
will enjoy seeing. 

The best applications will 
become presentations, viewed 
by a team of space experts — 
hopefully including Tim Peake. 


~HUNUU 


Individuals and groups of young people (of school 
age) can apply to the Principia Schools Conference 
events. There is no limit on the size of the group that 
can apply, but a maximum of six children along with 
two adults will be invited to attend. 


University of Portsmouth Wed 2 Nov 2016 


University of York Sat 5 Nov 2016 

Overseas applications are welcomed, though the 
judges will be giving first priority to applications 
from the United Kingdom, Channel Islands, and the 
Isle of Man. International applications of high calibre 
may be successful. 

The deadline for applications to both events 
is Thursday 15 September 2016 at 12 noon. 

To learn more about the Principia School 


Conference and how to apply, visit: 
magpi.cc/1ZNy9A2 
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feature | A BEGINNER'S GUIDE TO ELECTRONICS ON THE RASPBERRY PI 


ON THE y= 


Use the GPIO pins, some electronic components, 
and code to do cool stuff with the Raspberry Pi 


very month i The MagPi, In ee oe we're going to ; 
we have projects filling explain to you exactly how the 
the pages that hook up electronic components work and o—— 
directly to Raspberry Pi using the how you wire them up, along Oo-—_— 
GPIO pins running down the side with a bit of a briefing on how to 
of the board. They’re pretty easy program them with GPIO Zero, 
to use and, with some patience, before showing you some excellent 
you can figure out roughly how examples of the kind of things you 
they work by reading all the can do with Pi electronics when 
> ee ete FEMOr ats you know how. 


With the creation of the GPIO 


Zero Eyton ibiary, it sever been a 7 
easier to start coding electronics. All the code in 


With this in mind, we decided to this tutorial is 
sd remove the step between idea and | 
- ( 


®) 


o—— project by starting you off witha 
proper guide to getting electronics 
working with your Raspberry Pi. 


i — 
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feature | A BEGINNER'S GUIDE TO ELECTRONICS ON THE RASPBERRY PI 


started = 


RASPBERRY PI 


WITH 


=e 


7 


Reading circuit diagrams and wiring them up to your Raspberry Pi 
he Raspberry Pi is great 
for learning computing. 


we 
TT 
> Whether that’s coding 


or more advanced uses of a 
computer, the Raspberry Pi has 
lots of tools to aid you in learning 
about them. It’s also very good 


with the Pi is something like 
programming it to turn on an LED, 
an electronic component in an 
electronic circuit. 

The electronic circuits are 
the physical part of a physical 
computing project connected to 


only lights up when you press the 
switch. That is an electronic circuit. 


Reading circuit diagrams 
Building a circuit can be easy if 

you know what you’re doing, but if 
you’re making a new circuit or are 


Fig 2 Switch circuit 


the Raspberry Pi. These circuits can 
be simple or very complex, and are 
made up of electronic components 


new to electronics in general, you'll 
most likely have to refer to a circuit 
diagram. This is acommon way 


such as LEDs, buzzers, buttons, 
resistors, Capacitors, and even 
integrated circuit (IC) chips. 

At its simplest, an electronic 
circuit lets you route electricity to 
certain components in a specific 
order, from the positive end of a 
circuit to the negative (or ground) 
end. Think of a light in your house: 
the electricity passes through 
it, so it lights up. You can adda 
switch that breaks the circuit so it 


you'll see a circuit represented, and 
these diagrams are much easier to 
read and understand than a photo 
of a circuit. However, components 
are represented with symbols which 
you’ll need to learn or look up. 

Fig 1 is an example of the light 
circuit we talked about before. Here 
we have a power source (a battery in 
this circuit), a switch, a resistor, and 
an LED. The lines represent how 
the circuits are connected together, 


at physical computing, which in 
this context means programming 
and interacting with the real 
world through electronics. In 
simple terms, physical computing 


COMMON COMPONENT SYMBOLS 


>RESISTOR >BUTTON/SWITCH >CAPACITOR 


Credit: oomlout 
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Raspberry Pi1 


GPIO1 SDA1 |2C _ GpPIO21 
Raspberry Pi1 


GPIO3 SCL1 |2C GPIO20 
GPIO4 RaspberryPi GP1I16 
GP1O17 Model 2v14 GPI012 
GP1027 ID_SC l2C ID EEPROM 
GPIO22 GPIO07 SPIO_CE1_N 
GPIO10 SPIO_MOSI —_ GPIO8 SPIo_CEo_N 
GPIOg SPIo_MISO GPIO25 
GP1011 SPIo_SCLK GPIO24 
ID_SD l2C ID EEPROM GP1023 


GPIO5 GP1018 PCM_CLK 
GPIO6 GP1015 UARTO_RXD 
GPIO13 GP1014 UARTO_TXD 
GPIO19 
GPIO26 


GPIO1 SDA: I2C _ GPIO21 
Raspberry Pi1 
GPIO3 SCL1 l2C 


GP1O4 RaspberryPi GPI16 
Model 2 v1.1 GPlo12 


GPIO20 


ID_SC l2C ID EEPROM 

GPIO07 SPIO_CE1_N 

GP1O10 SPIO_MOSI GPIO8 SPIO_CEO_N 
GPIOg SPIO_MISO GPIO25 


GP1011 SPIO_LSCLK GP1024 
ID_SD l2C ID EEPROM GP1O23 
GP1I018 PCM_CLK 

GP1I015 UARTO_RXD 

GP1014 UARTO_TXD 
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GPIO ZERO 


read all the docs here: 


magpi.cc/10d1xtB 


What GPIO Zero is and how you can use it to 
program electronics connected to your Raspberry Pi 


» nce the components are 
all hooked up to your 
_ Raspberry Pi, you need 
to be able to control them. The 
Raspberry Pi is set up to allow you 
to program it with the Python 
simpler recently with the addition 
of GPIO Zero. 

GPIO Zero was created to 


computing, helping new coders to 
learn. It’s a Python library which 
builds upon the existing GPIO 
libraries RPi.GPIO, RPIO, and 
pigpio. However, while those 
GPIO pins themselves, GPIO Zero 
sits above them and provides a way 
to interface to the devices that you 
connect to those pins. 

This change simplifies thinking 
about physical computing. 


button to GPIO 4 and ground pins. 


In order to react to this button, 
we need to know that the pin 
should be configured with a pull 
up resistor, and that the pin state 
when the button is pushed will be 


in the classic RPi.GPIO library: 


from RPi import GPIO 
GPIO NUMBERS 


GPIO. setmode(GPIO.BCM) 40-pin GPIO header key for 
GPIO. setwarnings (False) Raspberry Pi 3, 2, B+, and A+ 
GPIO.setup(4, GPIO.IN, 
GPIO.PUD_UP) 3.3V 5V 
while GPIO.input(4): GPlo2 5V 
Dia GPIO3 GND 
print("Button pushed!") 
GPIO4 ) GP1014 
To complete beginners, there’s GNV GPIO15 
quite a lot going on there, which GP1O17 GP1O18 
gets in the way of actually GP1O27 GND 
experimenting with it and even 
eee ene ue ee GP1O22 GP1023 
teaching the simple logic required. 
Here’s the equivalent code in 3.3V GPIO24 
GPIO Zero: GPIO10 GND 
GPIOg GPIO25 
from gpiozero import GPio1u GPIOg 
Button 
GND GPIO7 
btn = Button(4) ire iti 
while not btn.is_ pressed: GPIO5 GND 
pass GPIO6 | | GP1I012 
web ("Dutton nushed!") 
print("Button pushed!") GP1013 GND 
The boilerplate, stuff you ies eke 
have to blindly enter without GPI26 GPIO20 
understanding why you’re GND : GP1021 
entering it, is reduced to the barest 
minimum that we can manage. GPIO Zero uses the BCM GPIO numbering rather 


a a : ; than the pin number - use this handy table to 
The name ‘GPIO Zero’ derives from remember which is which 


raspberrypi.org/magpi 


Connected to GPIO 4 
(pin 7), we've set this to 
be a GPIO Zero object 
called btn in the code. 
It is pulled up to ground 
using a resistor 


The LED is known as 
led in the code and is 
connected to GPIO 17 
(pin 11). The resistor 
makes sure the current 
going through the LED is 
right and goes to ground 


The Raspberry Pi 
interprets the signals as 
described by the code 

- in this case it creates 
awhile loop, a piece of 
code that repeats itself, 
which checks for button 
presses to turn the LED 
on and off 


Install the latest version of 


RASPBIAN 


to get full access to GPIO Zero! 
raspberrypi.org/downloads 


UNS 
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this ‘zero boilerplate’ philosophy, 
which was first espoused by Daniel 
Pope’s Pygame Zero library. 

The logic is also straightforward, 
with no curious inversion of the 
input value. 


Ways to turn on an LED 
GPIO Zero also tries to provide 
several means of attacking 
problems, as some coders may 
find particular methods easier to 
get their head around. Here, we’ve 
extended our script to control an 
LED attached to GPIO 17 with our 


button. Instead of looping to wait 
for the button, we use some of the 
available wait_for methods: 


from gpiozero import 
Button, LED 


btn 


Button(4) 

led = LED(17) 

while True: 
btn.wait_for_press() 
led.on() 
btn.wait_for_release() 
led.off() 


You can test this code with the 
circuit we created on the previous 
page. This method works fine for 
one button, but starts to get tricky 
when we want to use two. Say 
we’ve got buttons wired to GPIO 
pins 3 and 4, and we want the LED 
to light when either is pushed. This 
is quite hard with the wait methods 
above, so it makes sense to switch 
to ‘event-driven’ programming: 


from gpiozero import 
Button, LED 
from signal import pause 


btni = Button(3) 

btn2 = Button(4) 

led = LED(17) 

btni.when_pressed = led.on 

btni.when_released = led. 
off 

btn2.when_pressed = led.on 

btn2.when_released = led. 
off 


pause() 


Simple! But there’s a subtle bug. 
Hold down one button, then press 
and release the other; the LED goes 
off despite the fact a button is still 
being held; think about how the 
events are being fired to see why! 

Fortunately, GPIO Zero provides 
another programming style which 
solves this by allowing us to tie the 
state of the LED to the states of 
the buttons: 


from gpiozero import 
Button, LED 

from gpiozero.tools import 
any_values 


feature 


WHATS NEW IN GPIO ZERO? 
GPIO Zero can use buttons, 
LEDs, buzzers, and lots of other 
components. The library is 

ever expanding. 


>SERIAL PERIPHERAL 
INTERFACE 
Released in 1.2.0, there is now an 
SPI implementation for specific 
compatible devices to talk to the 
Pi. This allows for analogue inputs, 
analogue-to-digital converters, 
and other pretty advanced stuff, 
but it makes using them much 
more simple. 


>HOLD EVENTS 

These are variables in something 
like button code that allow you to 
set a length of time a button should 
be pressed before being recognised 
as a press. This can be useful if your 
button is very twitchy in a project 
you're using. 


>SOURCE TOOLS 


The tools library for the source and 


values properties enables you to 


tweak and play with the way GPIO 
Zero handles specific components 
and functions. We won't be covering 
them this issue, but they're important 
for advanced uses. 


from signal import pause 
btn1 = Button(3) 
btn2 = Button(4) 


led = LED(17) 

led.source = any_ 
values(btni.values, btn2. 
values) 


pause() 


This uses the new tools module 
from GPIO Zero 1.2, which is 
designed to work with the source 
and values properties used above. 
Basically, GPIO Zero is excellent 
for getting started with physical 
computing, yet is complex enough 
that you can do more advanced 
things with it than just wait fora 
button press. 
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Stop people from sneaking up on your stuff by 
creating a motion-sensing alarm that buzzes 
when it detects someone 


eu rN, eed to protect your room >STEP-01 
= 


; The PIR sensor detects or precious items from Attach PIR motion sensor 
T | motion via changes ) , : 
You in the levels of ne’er-do-wells or nosy First, we need to wire the PIR 
Need ita ica family members? With just a PIR (passive infrared) sensor to the 
motion sensor and a buzzer wired Pi. While it could be hooked to 
eee up to your Raspberry Pi, it’s very the GPIO pins directly using 
> 1x ->R501 , . , é 
Bic simple to create an intruder alert. female-to-female jumper wires, 
magpi.cc/ Whenever movement is detected we’re doing it via a breadboard. 
arwsEL7 in the area, a loud beeping noise The sensor has three pins: VCC 


> 1x Mini piezo will raise the alarm. To take things (voltage supply), OUT (output), 


sient r further, you could add a flashing and GND (ground). Use female- 
edo is LED, an external speaker to play to-male jumpers to connect VCC 
a message, or even a hidden to the ‘+’ rail of the breadboard, 


> Jumper wires . P 
Camera Module to record footage and GND to the ‘-’ rail. Wire 


of intruders. OUT to a numbered row, then use 
another jumper to connect that 
row to GPIO pin 4. 


The mini piezo buzzer 

ny tegpnlereeyepeicvan iar >STEP-02 

Wire up the buzzer 

Next, we’ll hook up the mini 
buzzer. Place its two legs 


To take things further, you could 
add a flashing LED or an external 
speaker to play a message 


across the central groove in the 
breadboard. Note that the longer 
leg is the positive pin; wire its 
While the PIR is powered numbered row to GPIO pin 3 on 
si ta ih fete ia the Pi to connect it. Wire the row 

of the buzzer’s shorter leg to the 
‘—? rail, then connect the latter 
to a GND pin on the Pi. Finally, 
connect the ‘+’ rail to the Pi’s 5V 
pin to power the PIR sensor. 
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PTRalarm.py 


O1 SDA1 12C GP1IO21 

03 SCL1 l2C GP1IO20 : 

O04 RaspberryPi GPl46 on DOWNLOAD: 

017 Model 2 v1.4 GPlo12 SP magpi.cc/1Ynsdop 


027 ID_SC l2C ID EEPROM PIR MotionSensor, Buzzer 
O22 GPIO07 SPIo_CE1_N 


time 
010 SPIO_MOSI GPIO8 SPIO_CEO_N S FE N SO R 


Og SPlo_MISO GP1O25 2 : 

011 SPlo_SCLK GPIO24 a MotionSensor (4) 

ID_SD I2C ID EEPROM GP1023 bz Buzzer(3) 

05 GP1018 PCM_CLK 

06 GP1015 UARTO_RXD ( ) 
013 GP1014 UARTO_TXD ‘ ; : 

bis pir.wait_for_no_motion() 

026 


pir.wait_for_motion() 

( ) 
bz.beep(@.5, @.25, 8) 
time.sleep(3) 


POS ecaacan 


> 


Feature 
THE HAYLER-GOOGDALLS 


he Raspberry Pi 3 is about 


ten times as powerful youll 


as the original model of | 
: Need Common cathode 
Raspberry Pi - and for people who RGB LED. The F 
‘ ; longest leg is the 
have been using the Pi for the past eine 


four years, you really notice the > oe 


difference. Even the jump to Pi2 : 
was quite big! While the original Pi 

would regularly max out the CPU, 

the newer Pis don’t do this as much. 

We can still track this CPU usage, 
though, and with a special LED that 
changes colours, we can create a 
light that tracks how much of the Pi 


we're using. a = 
LINY3HL3 


You can use any 


size breadboard for 
this circuit 


CSI (CAMERA) 


4 


is hh 


BUGRRRRRRRRRREE 


9 
= 


—« £ « & 


/ eeew_raspbderrypt.org 


http 


The resistors limit the 
current flowing through the 


(AVIdSId) ISd 
EREGRRRERRRREEE 
LED and prevent damage 
to the Raspberry Pi 
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Raspberry Pit 


Raspberry Pit rgb_cpumon.py 
gpiozero 
GPIO1 SDA1 l2c GPIO21 R3 RGBLED DOWNLOAD: 
GPIO3 SCL1 I2c GP1O20 ay psutil, colorsys, magpi.cc/1sy4eC2 
GPIO4 RaspberryPi GPI16 “ve time 
Model 2 v1.1 GPlo12 ii R2 
ID_SC I2C ID EEPROM a ts i myled = RGBLED(14,18,15) 
GPIO07 SPlo_CE1_N — 
GPIO10 SPIo.MOSI —_ GPIO8 SPlo_CEo_N i oan 
GPIOg SPlo_MISO GPIO : 
ine = 4 cpu = psutil.cpu_percent() 
GPIO11 SPlo_SCLK GPIO24 ane 
ID_SD |2C ID EEPROM GPIO23 iss , poe eege 
- nN 100Q 100 1200 O 
GPIO18 PCM_CLK 15% ( sia cpu)/100.@ 
GP1015 UARTO_RXD | 7 
GP1014 UARTo_TXD myled.color (r,g,b) 


time.sleep(@.1) 


ROB ZWETSLOOT 


Most selfie sticks 
use Bluetooth- 
connected buttons; 
ours is wired for no 
loss of signal 


lot of people roll their eyes 

and complain about vanity 

when it comes to the art 
of the selfie, but we all know it’s 
nothing like that. New outfit? New 
glasses? Eyeliner wings symmetrical 
today? Why not chronicle it? It’s a 
great confidence boost. Taking what 
we’ve done so far with GPIO Zero, 
we’re going to make use of a button 
with a Pi Camera and construct our 
own custom, Pi-powered selfie stick. 


STEP-01 


One thing we didn’t cover in the 
intro to electronics was how to 
install the Raspberry Pi Camera 
Module onto the Pi. Make sure yours 
is off and then find the camera 
connector; it’s the white rectangle erie hailed 
between the HDMI and audio ports pack to make the most 
on the Pi 2 and 3. Lift it up gently ea as 
and then place the Pi Camera ribbon 
cable in the slot with the silver 
connector facing the HDMI port. 
Push the slider back down. 


STEP-02 


We've useda 
full-size Raspberry 


Pi here, but you 
could always use 
the new Pi Zero 


BEERERRRRRRRREE 


To get the camera working on the 
Raspberry Pi and in Python, we 
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Raspberry Pit 


GPIO1 SDA: l2C _ GPIO21 
Raspberry Pi1 


GPIO3 SCL1 l2C GPIO20 


RaspberryPi GP1I16 

Model 2 v1.1 GPlo12 

ID_SC l2C ID EEPROM 

GPIO07 SPIO_CE1_N 

GPIO10 SPIO_MOSI GPIO8 SPIO_CEO_N 
GPIOg SPIO_MISO GPIO25 
GPIO11 SPIO_SCLK GPIO24 
ID_SD l2C ID EEPROM GPIO23 
GPI018 PCM_CLK 

GPIO15 UARTO_RXD 

GPIO14 UARTO_TXD 


Sl 


R1 
10kQ 


+5% 


elfie.py 


: DOWNLOAD: 
gplozero magpi.cc/Selfie- 
Button Camera 
datetime 
datetime 
picamera 
time 


btn = Button(14) 
pc = picamera.PiCamera() 


def picture(): 
timestamp = datetime.now() 
pc.capture( str( 
timestamp ) , 
time.sleep(1) 
ue: 
btn.wait_for_press 
picture() 


a 


You can use any model 
of Raspberry Pi with 
many of these projects 


Ultrasonic distance 


sensor — gives outa : 
pulse cine he he HC-SRo4 ultrasonic 


You can use any to any reflecting distance sensor is a great 
seven-segment object in front of it F A ; 

display, but favourite with Pi robot 
alternatives : 
as makers. It works by bouncing 
different pinout ultrasonic sound off an object and 


timing how long it takes for the 
echo to return. This time is then 
converted into a distance which 
can be displayed on a single-digit, 
seven-segment display. Here you 
can acquire the skills to handle 
inputs and outputs. You also get 
to use seven-segment displays, 
which are quite cool in a retro kind 
of way. 


STEP-0O1 


seeeeaeeeeceger 


(7) 8 |PPOW 


id Assaqgdsry 


SGREGRLAEE TASS 


The seven-segment display is 

a collection of LEDs, with one 

LED corresponding to one of the 
segments. All the anodes (positive 
ends) are connected together. This 
should be connected to the 3V3 
supply. The cathodes (negative 
ends) should be connected to a 
resistor to limit the LED current, 
and the other end of the resistor 
to a GPIO pin. To turn the LED on, 
all you have to do is set the GPIO 
output to be LOW (oV) and it will 
complete the circuit for the current 
to flow. 
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displayDistance.py 


re esa # displays the distance DOWNLOAD: 
in decimetres on 7 icc/1NqujmV 
segment display Sia gpernctcrha 
gpiozero DED 
gpiozero DistanceSensor 
time 
Breve uf seg [LED(27, 
alse), LED(25, 
), LED(24, alse), 
LED C23; 
alse) ,LED(22, 
alse), LED(18, se), 
LED(17, alse) ] 


segmentPattern = [[0,1,2,3,4,5],[1,2],[2, 
1,6,4,3],[@,1,2,3,6],[1,2,5,6],[0,2,3,5,¢ 
|, #0 to 5 


sensor = DistanceSensor(15,4) 


def main() : 
( 


distance sensor.distance 10 # 
distance in decimeters 
( ,» distance) 
distance 0.0: 
distance 16.€ 
display(int(distance) ) 
time.sleep(@.8) 


def display( Ne 
il range(@,7): 
seg[i].off() 
number LE 
al range(0, len( 
segmentPattern[ number ])): 
seg|[segmentPattern[ 
number ][i]].on() 


# Main program logic: 
__name__ 
main() 


feature 


ROB ZWETSLOOT 


| 

i 

4! 
y i - aa ‘ a L L', 
| ; Cc 1 ar a V1-TNE-T 
‘ - : 7 7 
7 .: 
é . a . = 
= 
z 


4 


Ds his one is a bit cool. The between five different stations using STEP-O1 
eer original code for this was variable resistors/potentiometers. 
a developed by The MagPi Now, with the latest version of GPIO Before we do anything with the 
boss Russell Barnes long before Zero, we’ve got it down to 21 lines, code, we need to make sure we 


GPIO Zero was a thing. Thecodewas although that does leave out volume can actually play the radio station. 
over 100 lines long and allowed you control for the moment. We’llshow  We’ll be using the online M3U 

to change the volume and select you how we did it. streams to do so, which can be 
found for many digital or online 
radio stations. Unfortunately, the 


i i 


Lid =) 


9 
cull BERR ERRRRRRRea 
ee 4 a 05) (01SP ff | 


Need 
7] 
The Raspberry Pi can't 
> = handle analogue inputs 
a on its own, so we need this 
= MCP3008 chip to do it Like the tuner of 
re radios of old, we can 
use this to change 
stations by twisting 
> 
> 
ERERRTORRERRREE 
> ’ (WWaWY dd 


| er ee ee | 
ee i 


The MCP3008 is 
hooked up to very 
specific pins on 


A i 


the Pi - they exist 
on original models 
as well 
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Ri 
100kQ 


CHO 


CH1 


CH2 


CH3 


CH4 


CH5 


CH6 


CH7 


MCP3008 


D_IN 


CS/SHDN 


DGND 


DAs 2! GPIO21 
Raspberry Pi1 c 


2c 102 
GPIO20 

RaspberryPi GPI16 
Model 2 v1.1 GPIO12 
ID_SC l2C ID EEPROM 

GPIO07 SPIO_CE1_N 


MISO 


GPIO11 SPIO_SCLK 


Raspberry Pi1 


internetradio.py 


ae ae DOWNLOAD: 
+ magpi.cc/10G2Y9i 
1me 
OSs 


Station dial = MCP30@8(0) 
Magic 


Radiol 


def change _station( Ne 
os.system( ) 
os.system( 

Station ) 


e 

Station dial.value aes 
Station = Magic 

change _station(station) 
Station dial.value so ges 
station Radiol 


change _station(station) 
time.sleep(@.1) 
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A Camera Module is used 
to record the fish swimming 
around inside the tank 


The tank has an LCD panel 
attached to the front 


The LCD displays an 
animated blend of desktop 
and recored fish footage 


» The Fish-eye 
was an art 
installation 
in Oregon 


» The tank was 


made from 
acrylic and 
acrylic glue 


» Five common 


goldfish lived 
in the tank 


» The tank cost 


around $50 
(£35) to build 


» It took 12 hours 


36 


for the fish tank 
glue to hold 


MagPi June 2016 


There’s something fishy about Thomas Hudson’s new monitor. 
We investigate the display that’s also an aquarium 


e adore this hybridised 

fish-tank and LCD screen. 

Known as the ‘Fish-eye’, 
the project was build by Thomas 
Hudson, a developer at the Oregon 
Museum of Science & Technology. 

The Fish-eye is a fascinating 

Cesare. J Vexcoeciied ini, wie ICID 
monitor is situated at the front 
of the tank, and the Raspberry Pi 
software superimposes the fish 
onto the display. “A Raspberry 
Pi Camera Module sits on top of 
the fish tank, looking down,” 
explains Thomas. 


Fish have a tranquil, calming 
effect, and watching them glide 
serenely around a tank while 
you work is awesome. And if you 
want to watch space fish, then 
the Earth or Moon make great 
fishy backdrops. 

“T built the tank out of acrylic 
using acrylic glue,” Thomas tells 
us. “It is amazing stuff: fairly 
toxic, but it welds the acrylic 
together so it is watertight. 

“The monitors were free,” 
he adds. “One from a free box on 
the sidewalk and another from a 


friend. Everyone is getting rid of 
19-inch monitors right now.” 

With the custom tank 
constructed, Thomas stripped 
down the LCD screen and fixed it 
to the front of the fish tank. 

“The camera captures live video 
of the fish from the top view and 
Siam elie tO incre loi tiie 
front of the tank. So when you’re 
looking at the front of the tank, 
you are looking at both live video 
of the fish from the top view while 
watching the ‘real’ fish as seen 
through the LCD screen.” 
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This intersection of moving life 


You don't actually see the fish. 
The camera records them and 
superimposes them on your desktop 


and still pixels gave the project 
its artistic message 


The Fish-eye uses quite a bit of 
bit of software to achieve its unique 
effect. It runs a picture program 
called Feh (feh.finalrewind.org) 
to flash full-screen images of 
space fish on the Moon. Oxmplayer 
(elinux.org/Omxplayer) is used 
to show the live stream and 
also recorded video of the fish. 
Fillalily; ine Raspoerny Pimms 4 
surveillance script based on Motion 
MMAL (magpi.cc/23MBxfH) to 
identify moving fish and attach 
bubbles to those fish displayed 
on the live video feed. 

“T worked on the project for 
about a month,” reveals Thomas. 
“Two shows were happening, 
so | made two Fish-eyes. One 
[was] for an annual electronics art 
exhibition called ByteMe! 5.0; the 
second was for the Portland Winter 
Light Festival.” 

This intersection of moving 
life and still pixels gave the 
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project its artistic message. 

“It was important for something 
to [be] living in the box,” 
explains Thomas. “This is 
juxtaposed against how much 
time we spend staring at a ‘box’ 
that is not living, and is very 
Milelhndeacd Wilh tnciexce prom 
of all those electrons buzzing 
through them and the cold 
emitting light.” 

The hishs>eve was Tebincd 
after the Portland Winter Light 
Festival was over, and the goldfish 
returned to a regular tank. “It was 
a sculptural piece,” says Thomas. 
“T feel that kids got it right away. 
They loved the idea of ‘fish on the 
Moon’ and ‘fish in space’. 

“T think there is something very 
beautiful about having depth to 
your monitor. You can still focus 
on your work, as the screen is 
crystal clear.” Indeed, we think 
the Fish-eye is a fabulous display. 
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This part of the build is as it looks: ’ 
the chimney stack allows for air — 
flow throughout the device 


MixiICco 


The box looks very classic, but it 
i belies a fairly high-tech interior 
for roasting coffee beans 


United States 


TTILVi Lich? Be 


A fun little addition allows 
for a flame effect to show 
when the roaster is on 


peg COFFER ROASTER 


in a cafetiere, 
also known as 


Tocco Want to up your coffee-making game even further? Make a cheap yet 
cites accurate coffee roaster, like Mark Sanders did, for a better cup 


Ethiopian, 
and Mexican 
beans have 
roasted well 


aking a truly good cup 

of coffee takes a lot of 

effort. Essential oils 
evaporate from ground coffee 
within minutes, so pre-ground 
coffee is out. Boiling water will 
burn the coffee as it’s brewed, 
So you need it at about 80-85°C. 
Giindisize exact Welents, precise 
timing, brewing method: all of it 
is important when making coffee. 
Possibly the most extreme step 
you can take is to roast your own 
beans to make sure they’re fresh 
and to your own requirements, 
and this is what Mark Sanders has 
found himself doing. 

“While in search of quality 

coffee, I stumbled upon a webpage 


» This is Mark's 
first Raspberry 
Pi project 


» The whole 
thing took 
between two 
and three 
months to build 


» The roaster 
is controlled 
by a custom 
web interface 


: 

i 
“y, 

- 


——————— 


c- he On OH 


The build 

effects on the 
case add an extra 
level of class 

to this custom 
coffee roaster 
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RASPBERRY PI COFFEE ROASTER 


GETTING THE PERFECT ROAST 


>STEP-01 


that suggested home roasting as a 
source of tasty coffee,” Mark tells 
us. “Getting started is as simple 
as purchasing a used popcorn 
popper from the local thrift store 
FOR SiO 81 

Popcorn poppers are popular 
among home-roasters, as they 
Stir the beans while very hot air 
blows on them - very similar 


>STEP-02 


from the popper and used them 
in another vessel. 

“T took the heater and fan 
from a popper and added several 
other components to create a 
temperature-controlled coffee 
roaster,” Mark explains. “A 
thermocouple was added to 
measure the temperature inside 
the roasting chamber. A GPIO pin 


I took the heater and fan from 
a popper and added several 
other components 


to commercial coffee roasters. 
There was a Small problem, 
though, according to Mark: 

“Tt roasted the coffee too fast, 
as I frequently finished roasts 
in under five minutes [when 
they should take 7-12]. In order 
to slow the roast down, I would 
unplug the popper for 30-second 
intervals. This grew tiresome and 
I started to ponder how I could add 


temperature control to the popper. 


This was the beginning of my 
Raspberry Pi project.” 

The solution is familiar to those 
who have tried (or at least seen) 
sous vide projects: controlling 
the heating apparatus. In this 
case, Mark cannibalised the parts 
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was connected to an AC relay that 
allowed the Raspberry Pi to control 
the popper’s heater. I developed 
a web interface to set the 
temperature and Save roast data 
for archiving. The web interface 
shows the current temperature 
using an analogue dial gauge, as 
well as a chart that graphs the 
temperature for the entire roast. 
For some extra flair, four LEDs 
were added to the front of the 
roaster to simulate a flame when 
the heater is turned on.” 

A full list of parts and 
instructions to build a roaster 
yourself is available online: 
magpi.cc/228QtW9. The build is 
quite fiddly, with a lot of soldering 


Projects 


and patience required, according 
to Mark. However, the results 
speak for themselves: 

“(The roaster] has completed 
Over 20 roasts and it has worked 
very well. I’m able to control the 
temperature throughout the entire 
roast process, log notes about the 
roast, and save the roast data for 
reference later. It’s much better 
than unplugging and plugging in 
the popper by hand.” 


Above The 
coffee roaster 
is controlled 
by a number 
of electronic 
components to 
get it working 
just right 


June 2016 MagPi 39 


BO! 


A robot that plays Connect 4 against a human 
opponent thanks to a bit of maths and code 


Quick 
Facts 


» The robot took 
two months to 
complete 


» Games at the 
Pi Birthday 
Bash were 


& 
PA 
ta 


A 


This is the robot's arm, which 
dispenses yellow pieces in 
an attempt to defeat humans 


Helpful instructions 
let you know when 
you can start and 
how to do so 


Plastic counters 

are recognised by 
colour and dropped 
into the game board 


limited to ten 
moves each 


» Only a few 
people won 
the game in 
ten moves 


» The add-on 
board that 
works the 
servos will soon 
be available 
as a HAT 


» David is 
currently 
converting an 
Ohbot to run on 
Raspberry Pi 
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ou may have seen 

computers that can 

defeat grandmasters at 

chess, win at trivia game shows 

or, more recently, beat a human 

at Go, but have you ever played 

Connect 4 against a robot? Humour 

us by answering no (statistically 

speaking, you probably haven’t) 

and then prepare to be amazed 

at the 4bot created David Pride. 
The 4bot has humble beginnings, 

as David explains its origins to us: 

“My wife bought me the brilliant 


MeArm kit and | used it to build 
a Lego block sorter, as you do. 
This used the Pi Camera Module 
and a colour recognition script 
I wrote in Python to identify 
the different coloured blocks, 
and then used the arm to drop 
them in the correct ‘buckets’.” 
A video of this can be seen here: 
youtu.be/FJ8WV1uLhFA. 
“Based on this, I was then 
looking for other uses for the 
colour-capture code,” David 
continues. “Connect 4 seemed 


like a really good choice. Research 
soon led me to find that the game, 
and the logic behind it, is far from 
simple. There is good information 
online; however, whilst I found 
many versions of Connect 4 
for Python, few of them ran 
successfully on the Pi.” 

The robot works by taking 
a picture of the game board, 
processing the colours, and then 
giving the game program the 
state of the board to calculate 
the Wextmmleie: 
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The 4bot was a smash at the 
Raspberry Pi fourth birthday 


party, with over 100 games played | . 


*s 


x 


‘J 


“In terms of how well it plays, 
Connect 4 is a ‘perfect’ game in 


mathematical terms,” David reveals. 


“There are a huge but finite number 
of solutions, and they can all be 
calculated with enough processing 
power. The trade-off is in the depth 
of search and therefore the time 
taken to calculate each move... If 
you increase the search depth, this 
massively increases the calculation 


Recognising the colours currently 
in play is not easy, though, and took 
a bit of trial and error to get right. 

“The trickiest part was 
undoubtedly capturing the game 
board accurately every time,” David 
tells us. “Itis extremely light— 
dependent, as the Python module 
works by capturing the RGB value 
of the 42 spaces on the board. 
These values, however, do change 


In terms of how well it plays, 
Connect 4 1s a ‘perfect game 
In mathematical terms 


time. So I selected a middle ground 
where the bot plays a pretty mean 
game, but the total time per move is 
still acceptable. With capturing and 
processing the image, calculating 
the next move, and delivering the 
counter, the total time per turn is 
around 25 seconds.” 


The Pi Factory Lego block sorter 
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dramatically depending on the 
lighting. I wrote a ‘testcard’ script 
that can be run with counters in 
known locations. This script then 
reports back what it thinks it sees, 
and the tolerances for the RGB 
components can then be adjusted 
until the result matches what is 
actually there on the real game 
board. This made the game more 
portable, as it can be adjusted to its 
surroundings each time.” 

Current upgrades for the robot 
involve a stronger frame, as it 
came in for heavy use at the fourth 
Pi birthday party. Maybe it’s time 
to bring robot Connect 4 battles to 
the next Pi Wars°... 


Projects 
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Projects 


The interface designed by Alain displays six cartoons. 
Scott uses the buttons to choose which video to play 


—_—_— 
» The build took 
two weeks to 
ee One MagPi reader has built a customised television 
» Arch Linux is ° ° : ° 
ee that his autistic son can use unaided 
interface 
> Videos are aving a child with autism The answer was to make Scott’s Sout had a 22 ine 1y im his 
played using isn’t easy. Alain Mauer’s bedroom “Scottcompatible! Youcan room because he loves to watch 
ra eed ke son, Scott, can’t make eye lock everything from the wardrobe cartoons, but one day he destroyed 
» The scripts contact and doesn’t talk. He also to the window, and we’ve installed it. So we tried another one witha 
were written Ae ; 73 
wing requires constant supervision. a camera in the wardrobe too. Plexiglass sheet in front of it, but 
Python 3.5 “Communication with Scott is But this isn’t much fun for Scott. he tried to destroy it too.” 
Reet very difficult,” says Alain. “He He doesn’t like staying alone in Alain started to wonder if the 
Kanner understands us, but can’t tell us his room and finds it boring. “He problem wasn’t the television, 
syndrome, what he wants. You can’t leave doesn’t play with toys or use his but what was playing. “He has no 
a severe form : oe 
ees him alone tor a single second. intial g Ween to play. But we Ener alpiity Ue: ell us, o) mine) stop iit, Gin 
“But from time to time he has that he likes cartoons with music,” his own,” explains Alain. “So he 
to stay in his room,” adds Alain. reveals Alain. gets frustrated, and tapping against 
— the noisy thing is his only way of 
co : : 
enjoying his new stopping it.” 
TV. He can bash | The answer was to builda 
the buttons (and - f 
screen) all day television that was Scott- proof, 
ious witout and the result is Scott TV: an 
' dbddada 9 «9 . 
Sa a ver unbreakable television with the 
praeeere rl Screen Indden insider six large 
waoaaaazap 


easily bashable buttons start and 
stop cartoons playing. A Raspberry 
Pi — tucked safely inside the wooden 
case — powers the whole project. 
Built out of 18mm multiplex 
wood, the Scott TV case houses 
the television, but it still needs 
protection. A sheet of 8mm 
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The television screen is housed 
inside a sturdy wooden frame 
and set back from the front. A 
sheet of Plexiglass protects it 
from being bashed 


mi. 


Plexiglass in front of the display is 
the solution. “It wasn’t complicated 
to build,” says Alain. “Witha 
jigsaw, a drill machine, and a little 
table saw, all is possible. 

“The Raspberry Pi is the main 
part of the project. Normally, I tell 
everybody that the Pi is optimised 


The Raspberry Pi displays 
a menu with six cartoon 
options. When a button is 
pushed, the corresponding 
movie starts to play 


Six piezo sensors sit next to 
the screen. On the other side 
are large, handmade buttons 
that Scott can bash without 
damaging the television 


any button when a movie is playing, 

it returns to the menu Screen. 
“Tused NOOBS to install Arch 

Linux. For [a] console-based media 


player, I used Omxplayer. I then used 


Python 3.5 to write the scripts. ’m 
not a Linux expert or a programmer, 
so Google was my friend. The 


To see him so happy was the 
biggest thank you from him to me 


for controlling stuff and not as a 
media player. But I was wrong: it 
plays full HD videos.” 

The scott TY tas six lanee 
buttons, handbuilt by Alain with 
piezo switches on the inside. “The 
buttons were the challenge,” says 
Alain, “but you can use any kind 
of buttons.” 

The menu displays previews 
from six cartoons (one next to each 
button). If Scott pushes a button, the 
cartoon Starts playing. If he pushes 
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Scripts are available on GitHub 
(magpi.cc/22amFIG). 

“Since it was set up in his 
room, Scott likes to stay longer 
and push the buttons,” Alain 
tells us. “Sometimes he sits in 
front of the media player and just 
looks at the animated menu, 
or he plays the Twinkle Twinkle 
Little Star video ten times and 
laughs. To see him so happy was 
the biggest thank you from him 
to me.” 


>STEP-02 


SCOTT TV 


Projects 


CREATING 
SCOTT TV 


>STEP-03 
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Sense HAT 
magpi.cc/ 
1TGGUt5 


Dynamic DNS 
service 
magpi.cc/ 
1TSwg3g 


Matplotlib 
magpi.cc/ 
aTSwgAt 


Running web 
server 
magpi.cc/ 
1TSwis8 


Virtual host 
magpi.cc/ 
aTSwiYU 
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Date 


Data taken from the Sense HAT 


can be easily analysed, once 
plotted out like this 


Taking advantage of Matplotlib's 
powers, the date is shown 
ina correct format 


MAKE A SENSE HAT 
TEMPERATURE 


RECORDE 


WITH 
PY THON 


Data obtained from the Sense HAT can be plotted directly with Matplotlib. 
With a running web server, this data can be tracked from anywhere! 


he Sense HAT enables us to measure different 
parameters of our environment. However, 
the raw data obtained from the sensors can be 
unmanageable. Plotting the data can help us analyse 
it much more easily; with Python and the powerful 
Matplotlib library, we can both obtain data from the 
sensors and create a wide variety of graphs to turn 
boring numbers into intuitive results. We can also 
enable a web server and create a virtual host to host 
the plots so we can access them over the network, 
creating a beautiful dashboard. While there are 
services which already provide this, we can build our 
own for free. 

Sense HAT is probably one of the bests HATs you 
can get for the Raspberry Pi, with plenty of sensors to 
play with. There are some services that let you take 
advantage of these sensors and create interactive 
dashboards, allowing you to see plots of the data from 
the sensors with just a network connection. However, 
these services are usually too limited unless you pay 
for a subscription. 


Matplotlib lets you create graphs from Sense HAT data, 
making it the perfect partner for the HAT. It can make a 
lot of different graphs, but in this tutorial only the basic 
one-line plot is going to be covered. 


Setting up the web server 

With a dynamic DNS (DDNS) service, a running web 
server, and a virtual host, you can create your own 
dashboard. While the virtual host, web server, and 
DDNS service are not essential, without them it would 
only be possible to track the results locally. Let’s 
suppose that while you are reading this, you have 
already set up everything you need. 

The first step is to create a folder called dashboard 
in /var/www. In this folder we will save the CSV file 
generated by the program, with all the data, and also 
the HTML or PHP files to create a beautiful dashboard. 
There are a lot of tutorials out there on how to make 
your own personalised, custom dashboard. After that’s 
done, create a folder called images in /var/www/ 
dashboard, in order to save the created graphs there. 
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Above Different plots can be made: for example, one with two 
lines that measures temperature and humidity over time 


Importing required libraries 
In the Python code, we need to import different 
libraries: csv in order to write data to a file, datetime 
in order to get the date, and matplot1lib to create the 
plots. After importing these, we first need to be sure 
that the program can run without an X server running; 
that’s why the matplotlib.use("Agg") function is 
used. Now we also need to import matplotlib.dates 
to format the date for the plot, matplotlib.pyplot 
to draw the plot, SenseHat to get data from the Sense 
HAT, and finally time, since we’re going to execute all 
the code inside awhile loop, with a value for time. 
sleep of 3600 seconds. 

Matplotlib needs a list of two values to plot them, 
that’s why we create x and y empty lists. Now we 
can start taking temperature data from the Sense 
HAT, and also the date that corresponds to the value 
of the temperature. 

Once the data is taken, a CSV file is opened in 
append mode to add the data. This way, we can 
also have the raw data and not only the plot. 


Creating the graph 

Instead of taking the data from the CSV file, Matplotlib 
directly plots the lists that were previously created. To 
add data to the list, we just append the read temperature 
and date values to them. With the data on the lists, we 
can plot the graph and afterwards format both axes and 
write the proper labels. The final plot-clearing section in 
the code is required: if not included, the new plot would 
be drawn over the old one and make a mess. 

The code is only an example, but can be used as the 
basis for amazing programs. As mentioned, Matplotlib 
is So powerful that we can create other kinds of plots 
as histograms or animated plots. While the Sense 
HAT is used for this tutorial, any other sensors can be 
used. Also, data could be directly taken from raw data 
files rather than sensors. All this will be covered at the 
author’s GitHub repo (magpi.cc/1W1QZ35) soon. 

Matplotlib was created by John D Hunter. He passed 
away in 2012, and this tutorial and all the programs 
made with his amazing library should be considered 
in memory of him. 
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DashboardPi.py panes 


#!/usr/bin/env python 


DOWNLOAD: 
#-*-coding:utf-8-*- magpi.cc/1W1QZ35 


# Create graphs with temperature and data. 


# Created by Iker Garcia. 


import csv 

import datetime 
import matplotlib 
matplotlib.use("Agg") # Added to plot graphs without running X server. 
import matplotlib.dates as md 
import matplotlib.pyplot as plt 
from sense hat import SenseHat 


import time 


x< 
I 


[] # Define list needed for the plot. 
[] 


< 
I 


while True: 
try: 

sense = SenseHat() 
temp = sense.get_temperature() # Reads temperature from Sense HAT. 
temp = round(temp, 2) 
now = datetime.datetime.now() 
file = open("/var/www/dashboard/temperature.csv", "a") 
# Opens file to save data. 
writer = csv.writer(file, delimiter = ",") 
data = [now,temp | 
writer.writerow(data) # Writes data on the csv file. 


x.append(now) # Updates list for the plot. 
y.append(temp) 


plt.plot(x,y) # Plots data set. 
plt.gca().xaxis.set_major_formatter( 
md.DateFormatter("%Y-%m-%d %H:%M:%S")) # Format the date. 
plt.gca().get_yaxis().get_major_formatter().set_useOffset(False) 
# Format y axis, in order not to get scientific units. 
plt.xlabel("Date") # x axis label. 
plt.ylabel(u"Temperature (\u@@B@C)") # y axis label. 
plt.gcf().autofmt_xdate() # Correct date format on the axis. 
plt.savefig( 
"/var/www/dashboard/images/1.png", bbox_inches = "tight") 
# Save the plot with the optimal size. 
plt.clf() # Clears the plot, in order to get a tidy plot. 


time.sleep(360@) # Code is executed each hour. 


except KeyboardInterrupt: 


break 
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Recreate arcade classic 
Asteroids, or as we like to 
call it,: 4573R01D5 


The rocks in the game now have 
collision detection, meaning 
there's now real danger 


MAKE AN 
IN FUZE BASIC 


Finish making an incredible Asteroids clone in FUZE BASIC 


> Raspberry Pi 
with updated 


Raspbian 


> FUZE BASIC 
magpi.cc/ 
1aSbgYsY 


> Sound files 


> Last month's 
fexeye (=) 
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with part two of our tutorial 


ast issue, our ‘4573R01D5’ game started to 
take shape with movement, firing and, of 
course, our menacing rocks floating around. 
With that, the basic mechanics of the game are there, 
but there’s no gameplay to speak of yet. This final 
tutorial adds collision, spaceships, scoring, sound, 
hyperspace, an attract screen, and the obligatory high 
score table. 
You'll need FUZE BASIC. Visit: 
www.fuze.co.uk/getfuzebasic/ to get the 
latest version. 


Continue? 

To start, grab the files needed: magpi.cc/1WBCalIG. 
Start up FUZE BASIC and load 4573R01D5 into 
the editor. To do this, after starting FB you’ ll be 


JON SILVERA 


CEO and founder of FUZE 
Technologies, Jon Silvera is keen 
to help kids learn how to code. 
fuze.co.uk 


With this final step, you can 
actually play the game as it 
was intended 


presented with Direct mode, so press F8 to load a file 
or F2 to go to the editor and then load a file. You’ ll 
then see the full program listing. There’s a lot of 
code that’s in the final version; we’ll go through how 
it all works in this tutorial. 

The program consists of a main LOOP, then a 
whole series of PROCedures to perform all the 
main functions. 

It’s important to note that the WAIT command sets 
a maximum delay minus the amount of time taken 
in milliseconds. On a fast system, you should set 
this toWAIT ( @.016 - (timeTaken / 100@)) 
to maintain a constant 60 frames per second. On 
a Raspberry Pi 2, a delay of 0.010 is better —- and 
remove it altogether if running on an original Model 
B or B+. Play around to see what you like. 


raspberrypi.org/magpi 


MAKE AN ASTEROIDS CLONE IN FUZE BASIC 


Explaining the player code 

Every time the player is initially placed on the screen, 
we use DEF PROC initialisePlayer to make sure 
that there are no rocks nearby. Each asteroid has its 
distance to the player checked and if it’s too close, we 
update the asteroids and try again. Note that this is 
not UPDATEd, so isn’t seen. 

The DEF PROC newExplosion(exX, eyY) routine 
is called every time a bullet hits a rock, a rock hits 
you or an enemy, or if an enemy hits anything. A new 
explosion is created and put in motion to be drawn 
by the next routine. DEF PROC drawExplosions 
takes us through the active explosions, and each one 


This final tutorial adds collision, spaceships, 
scoring, sound, hyperspace, an attract screen, 
and the obligatory high score table 


of its variables is updated so that each bit of debris 
(a pixel!) moves in the given direction and at the 
designated speed. 

When a player loses a life, all the variables required 
to start a new life are set up once again using DEF 
PROC resetPlayer. Basically, everything is reset and 
repositioned as though the game were just beginning, 
but score, level, and other gameplay data is left alone. 

Drawing the player ship is handled by DEF PROC 
drawPlayerShip and is the simplest routine in the 
entire program. It just runs through the x andy 
coordinates held in the playerData array and plots 


We’re not allowed to hold down the fire button 
and we’re only allowed a maximum of five bullets on 
screen at once. So, if the RETURN key is pressed and 
isn’t being held down, and the number of bullets is 
less than maxPlayerBullets, then we’re good to 
go! Finally, we check to see if our ship has left the 
screen and if so, reposition it on the opposite side. 


>FUZE BASIC 


DOWNLOAD: 
magpi.cc/1WBCqIG 


Display the action 

In DEF PROC silvoids, a LOOP goes through each 
asteroid -@ TO maxSilvoids LOOP. We check for 
off-screen and wraparound if needed; next, we figure 
out what kind of asteroid it is (the type, size, and 


FUZE BASIC 


As it’s based 

on the BASIC 
programming 
language, if 
you still have 
BASIC skills left 
over from the 
eighties, they'll 
still mostly 
apply today. 


number of lines), then draw the rock. The screen itself 
is drawn with DEF PROC drawScreen, which also 
displays the score, any text, and the number of player 
ships remaining on the screen. 

The statement DistCheck = FN distance 
(silvoid (count, sX), silvoid(count, sY), 
pX, pY),inDEF PROC collision, works out the 


FUZE 


the line. Note that if pThrust (player thrust) is active, = 


then a couple of extra lines are drawn to show it. 
There’s also the DEF PROC explodePlayer routine, 
which draws a few tiny lines and then expands them 
over a few frames to simulate the ship exploding. 


Coding the gameplay 

Let’s start with DEF PROC gameOver. This simple bit 
of code displays the ‘GAME OVER’ text briefly when 
you lose. DEF PROC newLevel resets the asteroids 
and positions the player in the centre of the screen, 
ready to begin a new level. DEF PROC resetSilvoids 
resets the asteroids, based on the current level plus 

a minimum of 4; it starts at 5 on level one, then 
increases by one for each level. Each asteroid is given 
a shape type, position, speed, and direction. 

For moving the ship, the code uses DEF PROC 
playerControls. Here, scanKeyboard(scankey) 
checks for multiple keys at the same time. Z and X 
rotate the ship. Next, we check for thrust (RIGHT 
SHIFT). If thrust is active, i.e. TRUE, then thrust/10 is 
added to the player’s x and y position. Finally, we add 
a decelerator using pThrustX = pThrustX * @.995, 
so the ship slows down of its own accord. 
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As well as FUZE BASIC, which brings the BASIC 
language up to date, you can also get FUZE 


hardware that’s reminiscent of the BBC Micros from 
the eighties. They're also powered by Raspberry 

Pi and you can do some GPIO electronics on them 
as well. Playing this custom version of Asteroids on 
here is sure to trigger nostalgia in certain people. 
You can have a look at the available models on the 
FUZE website: fuze.co.uk/products 
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The game 
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displays them on 


the attract screen 
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distance between each asteroid and the player ship. If 
it’s less than the radius of the ship and the rock, i.e. 
touching, then it’s a crash! When we hit a big rock, 
we want it to break into two, then again for a medium 
one; if it’s a small one, there’s just the explosion, so 
we use DEF PROC silvoidSmash to do this. 

DEF PROC newPlayerBullet scans through 
the maximum number of bullets and if it finds 
an empty slot, creates a new one. DEF PROC 
drawPlayerBullets checks to see if we need to wrap 
them around the screen, calculate their updated 
positions, and draw a little circle in place. 


Setting up the game 

All the initial setting up takes place in DEF PROC 
setup. If you want to try some early hacking, this is 
where you begin. DEF PROC hiScoreFile creates an 
initial high score list. 

DEF FN distance(fnx1, fny1, fnx2, fny2) is 
without a doubt the most important five lines of code 
in the entire program. This function works out the 
distance between two points, which we then use to 
check if any two objects collide. 

Then we have DEF PROC text(textText$, 
textX, textY, tR, tG, tB, textSize, bold) 
and DEF PROC fontData. The first routine draws 
our text to the screen, but using vector lines and not 
system fonts. We can also draw symbols, but a simple 


tiny circle is used for a full stop. The second routine, 
fontData, reads all the character data. The data is 
represented as ‘A’, the actual character, and then a 
number specifying how many coordinate points are 
required for that character. 

The score routine, DEF PROC score(points), 
is Separate so that we can keep a close eye on the 
score itself. We need to add a new life for every ten 
thousand points, so we have a second scoreCheck 
to keep track. 

DEF PROC initialiseSounds could be included 
in the main setup, but it can be good to keep things 
separate where possible. It’s where we load in and 
define our sound effects and music. 


Create a demonstration 
The routine DEF PROC attractScreen uses an 
array to store numerous copies of the ‘4573R01D5’ 
logo, each with a slightly different x and y position, 
size, and colour fade. These are calculated using COS 
and SIN to create the circular and wavy effects you 
see on the title screen. A rather fine tune is played 
in the background, too. Hats off to David Silvera 
for that one! 

The attract screen also uses the DEF PROC 
colourChange procedure to select new colours 
for the logo, anda high score table is created with 
DEF PROC enterHiScore. An arcade game is never 
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RELEASE DATE: NOVEMBER 1979 


DESIGNERS: LYLE RAINS, ED LOGG, 


AND DOMINIC WALSH 


PUBLISHER: ATARI, ING 


HARDWARE: MOS TECHNOLOGY 6502, 


QUADRASCAN 


HIGH SCORE RECORD: 3 41,338,740, 
JOHN MCALLISTER, 


6 APRIL 2010 


The original Asteroids is one of the first major hits 
of what is considered the golden age of arcade 
games, during the 1970s and early 1980s, when 
video games were just starting out. Games in this 
era are typified by classics such as Pong, Space 
Invaders, and even Pac-Man. Asteroids wasn't 


wholly original, though, being based on concepts 


from a few previous games such as Spacewar! and 
Computer Space. However, the final product was 
different from the handful of shoot-'em-ups that 
preceded it. 

Asteroids existed in a time when vector graphics 
and (now considered traditional) pixel-based 
raster graphics were still both used, depending on 
what type of game you were making. Vector was 
used for Asteroids to allow for greater precision 
from the shots fired by the ship, resulting in its 
iconic triangle ship and asteroids, and other minor 
graphical effects. 

Atari began to port Asteroids to its various home 
gaming console models during the Eighties, 
strengthening its legacy as one of the all-time 
greats of video games. 


complete without a high score table where you can 
add your own initials. While this is showing, the 
game plays in the background, albeit without the 
player. Use Z and X to select letters and # to confirm. 

When we start a new game from within a game, we 
only need to set a few variables rather than setting 
everything all over again. DEF PROC gameVariables 
handles that. If no enemy ship is in play, then DEF 
PROC enemyShip creates a new one, introducing it 
based on a random timer which is shortened by the 
level number. Also, bullet frequency, ship speed, and 
size of the enemy are all influenced by the level. 

The enemy bullet routine DEF PROC 
drawEnemyBullets counts through all the active 
ones in the array and if TRUE, plots a tiny circle in 
place. Finally, DEF PROC newEnemyBullet is the last 
procedure but also quite acool one. ATAN (ABS (ty3 
/ tx3)) is used to determine the angle of the player 
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* Explosive rapid-fire space action * | or 2 players are challenged to destroy asteroids and enemy 
spacecraft * New Atari-designed QuadraScan™ display system * New personal high score table display * Optional 
“Hyperspace * Optional coinage including Susan B. Anthony coin slot * Bonus play at 10,000 points. 


ARCADE 
PERFECT 


ship in relation to the enemy ship. We then modify 
this with eBullet(n, eBaccuracy), calculated 
using a random angle divided by the level. We start 
with a potential angle of up to +180 degrees divided 
by the level (divided by two to be kind). By level 20, 
this comes down to a +9 degree accuracy range. The 
result is that enemy bullets become more precise 
as the levels progress. It also has the bonus effect 
of making the enemy seem intelligent, as they will 
sometimes fire just ahead of you. Very nasty! 

At around 1,100 lines, 4573R01D5 has become quite 
the chunk of code. It is, however, incredibly small, 
as the whole thing is just under 39,000 bytes, or 
38kB. It would compress down quite a lot if we took 
all the comments out, and it could be optimised 
to bring it down much further. Quite simply, 
with a bit of tweaking, it would comfortably fit 
onto a ZX Spectrum! 


June 2016 MagPi | 51 


Tutorial 


These wires with 
bullet connectors 
go to the tower light 


eo , 
i) a Same (cy 
te «ten 


Asimple circuit board 
to switch 12V safely 


tg ») ry 
© @/MP: ©) ©) @) @) @) ©) @) 1 @)1® 
©: 6 wee) @) @' @) @) @: @' 1 @'®@ 


yy” 


Power lead and micro- 
USB connection for the 
Ethernet adaptor 


> IRLB8721 
MOSFETs 


> 220-ohm resistors 


>12V DC 
tower light 
magpi.cc/ 
arGNbwB 


> 12V power supply 
and jack 


>12V to USB 
converter 


> Perma-Proto HAT 
magpi.cc/ 
1TQQcn8 


> Micro-USB to 
Ethernet adaptor 
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> Miscellaneous 
other parts 


Using some 
neodymium 
magnets, you can 
mount the tower to 
any metal object, 
such as a closet or 
fridge door 
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BRAM DRIESEN 


A Drupal developer for Capgemini, 
he loves to ‘bake’ projects 

with Raspberry Pis and fly 

with multicopters. 

@BramDriesen 


12V to USB converter to 
power the Raspberry Pi Zero 
from the DC 12V input 


a 


CREATE A 
JENKINS BUILD 


Jenkins is a great tool to monitor code quality. For greater visibility 
of the build status, you can build an awesome tower light that uses it 


magine being able to show the status of 

your Jenkins projects to anyone in the same 

room without the hassle of logging in to 
the dashboard. With some LEDs, a few other cheap 
components, and some soldering skills, you can 
complete this project. You can take it to the next level, 
however, by using an industrial tower light instead 
of regular LEDs. Employing an existing API, you can 
retrieve almost any data from Jenkins and get a nice 
visual indicator of the status of your project. 


Make a HAT 

First, we need to create the HAT. We used a Perma- 
Proto board from Adafruit, but you can also use a 
breadboard if you don’t want a permanent solution. 
In this version, the following GPIO pins were used, 
since they best fit the layout: 
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PIN 18: Red 
PIN 23: Buzzer 
PIN 24: Yellow 
PIN 27: Green 


You can use the GPIO output voltage in combination 
with a MOSFET and a resistor to switch 12V safely to 
the LEDs. There’s also a12V to USB converter to power 
the Raspberry Pi from the barrel jack, and a small 
power switch. 


>STEP-02 

The Python Jenkins-API 

You need to start off with a clean Raspbian Jessie 
image (not the Lite version) and a Raspberry Pi Zero 
(make sure to solder the GPIO header pins!). After you 
have burned the image and completed the basic setup, 
make sure to set up an internet connection. You can 
either use a Standard WiFi dongle or a micro-USB to 
Ethernet adaptor. Once you are ready, proceed with 
the installation of the Jenkins API. In the terminal 
window, enter the following command: 


sudo apt-get install python-jenkinsapi 


>STEP-03 

Create the Python script 

Most of the coding work has already been done for 

you and is available on GitHub. To get everything you 
need for this project, clone the project from GitHub on 
your Raspberry Pi by using the following command in 
your terminal: 


git clone https://github.com/BramDriesen/ 
rpi-jenkins-tower-light. git 


Make sure to clone the project in a directory where you 
can easily find it afterwards, such as the home directory. 
Youcanusecd <folder>/<name>andcd ../ 
commands to navigate through folders in your terminal. 
You can also download a ZIP file of the source code from 
the versions page: magpi.cc/1irGOjAt. 


>STEP-04 

Configure the code 

Now we have cloned the project, we’ll browse into 

the directory to configure the Python script. Copy the 
default configuration file default-config.py and rename 
it to config.py. Youcan use the command cp default- 
config.py config. py to do this all in one go. After 

you have copied the file, edit it with your favorite text 
editor; we like to use nano, so in this case we’d issue the 
commandnano settings. py. Now change the default 
configuration lines so it contains your credentials, 

job name(s), and correct GPIO pins according to your 
situation. If you have only one job, make sure the jobs 
parameter remains an array with one item inside. 
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Default-conjig.py 


# Default configuration file for Jenkins 
# Copy this file and name it config.py 
jenkinsurl = "http://example-url.com:8@80" 


username = "your-username" 
password = "your-password" 
jobs = ['job-name-1', 'job-name-2' | 
gpios = { 
"red': 18, 
‘DUZZeEr i) 23, 
‘yellow': 24, 


"green': 27, 


>STEP-05 

Auto-run on boot 

Since we’re working on a permanent solution, we 
want to ensure that our script launches immediately 
on boot. We can edit our rc.local file to launch the 
Script when the Raspberry Pi is booted up. Edit your 
rc.local file with sudo nano/etc/rc.local and add 
the following line to direct the script to auto-start 
upon boot: 


python /path/to/the/script/rpi-jenkins- 
tower-light/jenkinslight.py & 


Reboot your Pi and you should be good to go! For 
maintenance, you can always SSH into the Raspberry 
Pi in the future. 
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A schematic 
layout of the 
circuit board to 
control the LEDs. 
It may look a little 
complex, but just 
be careful to wire 
it up properly 
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RICHARD HAYLER 


Richard is a mentor at CoderDojo Ham, and 
, his school CodeClub was one of the winning 
ay teams in the Primary Astro Pi competition 

. whose code ran on the International Space 
Station in February. 
richardhayler.blogspot.co.uk 
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‘ewe FREE-FALLING 
& WITH SENSE HAT 


sense_hat, evdev 
& select Libraries 


> Something eo: il Why do astronauts on the ISS float? 


to provide a metres is sufficient to 
soft landing measure free fall i aah like Tj 
occas SK most peop CW Vy astronauts like lim 


power bank 7 Peake float around on the International Space 

Don't throw the Station and there is a good chance they’ 1] 
Tene say, “Because there is no gravity.” If you think about 
it, this can’t be the case. The ISS orbits the planet at 

400km, but the Moon is nearly 100 times further away 

and is still subject to Earth’s gravitational pull. So 

why are astronauts weightless? It’s because the ISS 

is constantly in free fall, and so the astronauts living 

inside it experience weightlessness. 

This can be difficult to wrap your head around, so 
we’ ll use the Sense HAT to explain it. 

If you’ve been following the previous Sense HAT 
Science articles, this should all be familiar now: attach 
the Sense HAT to your Pi and power it up. Open IDLE3, 
or just type python3 in a terminal window, and then 
import the SenseHat library and connect to the board: 


from sense_hat import SenseHat 
sh = SenseHat() 


There are a number of ways we can measure motion, 
forces, and orientation with the Sense HAT: it has 
a gyroscope, magnetometer, and an accelerometer. 
We’re going to use the accelerometer, and the line 
of code we need probably won’t be a surprise: 


sh.get_accelerometer_raw() 


We’re using _raw() as it returns results in Gs. One 
| G is equal to the force of gravity on the Earth’s surface 
Make sure you provide Pay . (9.8m/s), and you often hear jet planes, spacecraft, and 
something soft for the We ; ; 
Bi zo lanclon even roller-coasters described in terms of how many Gs 
| their riders experience. 

The three values measured by the Sense HAT - x, y, 
and z — correspond to the pitch, roll, and yaw axes. If 


we run the following Python snippet: 


while True: 
print(sh.get_accelerometer_raw() ) 


7 
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...then we should see a continuous stream of the 
x, y, and z values displayed on screen. Jiggle and 
wiggle the Pi and Sense HAT around and see how the 
numbers change. Can you carefully move the Pi so 
that just one of the axis values changes? 


Taking readings 

For our experiment, we need to able to record x, y, 
and z readings constantly and save them to a file so 
that we can analyse them later. To make things easier 
(and to make our data file smaller), we will use the 
joystick to start and stop recording. There are several 
ways of doing this with Python, but the code uses the 
evdev library to register joystick presses. 

To run the experiment, power the Pi up from 
a battery pack and secure the two together 
using rubber bands or cable ties. Start the code 
and then disconnect the keyboard, mouse, and 
display cables. 

Now find somewhere from where you can drop the 
Pi. The greater the distance it falls, the easier it is to 
see the free-fall period. However, don’t forget that 
you need a big, soft landing zone! 

When you’re ready, press the joystick and you 
should see the 8x8 LED matrix light up all green. 
That means data is being recorded, so bombs away! 
Once the Pi has landed, press the joystick again to 
end the logging (the LEDs should briefly flash red, 
then turn off completely). 


Analysing the data 

For the data analysis, we can also use the Pi. Plug all 
the cables back in and start up LibreOffice Calc. The 
code conveniently writes the data into a CSV format 
that can easily be ingested by this (or any other) 
spreadsheet program, which can be used to plot 
eraphs of our data. 

From the graph, you should see that before the 
drop, the Sense HAT accelerometer measures 
approximately +/-1G, then falls/rises to 0 while 
it is falling. You’ll probably also see the ‘bump’ 
corresponding to the landing (hopefully not too big). 

So, now we’ve shown that a falling object will 
experience zero G, we can see why astronauts on the 
ISS appear to float. However, if the ISS is constantly 
falling, why doesn’t it just crash into the Earth? This 
is because the Space Station is also moving ‘forward’ 
at a speed fast enough to ensure that it keeps missing 
the Earth and stays (falling) in orbit. 

You can, of course, use the Sense HAT to measure 
forces greater than 1G, too. Try taking your portable 
Pi and Sense HAT on a playground ride or, for some 
serious Gs, a theme park attraction. If you’re going 
to take your Pi and battery pack on a roller-coaster, 
though, make sure it is securely stowed away 
in a zippable pocket! 
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Tutorial 
qanguage 


e 
gravuly.py PYTHON 3 
from sense hat import SenseHat 
from datetime import datetime 
import sys 

from time import sleep 

from evdev import InputDevice, ecodes, list _devices 
from select import select 

import logging 


DOWNLOAD: 
magpi.cc/1X0qOOu 


# Use the logging library to handle all our data recording 


logfile = “gravity-”+str(datetime.now().strftime(“%Y%m%d -%H%M” ) ) +”. csv” 


# Set the format for the timestamp to be used in the log filename 
logging. basicConfig(filename=logfile, level=logging.DEBUG, 
format=’%(asctime)s %“(message)s? ) 


def gentle _close(): # A function to end the program gracefully 
sh.clear(255,0,0) # Turn on the LEDs red 
sleep(@.5) # Wait half a second 
sh.clear(@,0,0) # Turn all the LEDs off 
sys.exit() # Quit the program 


sh = SenseHat() # Connect to SenseHAT 
sh.clear() # Turn all the LEDs off 
# Find all the input devices connect to the Pi 
devices=[InputDevice(fn) for fn in list_devices() ] 
for dev in devices: 
# Look for the SenseHAT Joystick 
if dev.name==”Raspberry Pi Sense HAT Joystick”: 
js=dev 
# Create a variable to store whether or not we’re logging data 
running = False # No data being recorded (yet) 
ery: 
print( ‘Press the Joystick button to start recording.’ ) 
print( ‘Press it again to stop.’) 
while True: 
# capture all the relevant events from joystick 
r5w, x=select([js.1d],/],[],0-@1) 
Tor fd in rt 
for event in js.read(): 
# If the event is a key press... 
if event.type==ecodes.EV_KEY and event.value==1: 
# If we’re not logging data, start now 
if event.code==ecodes.KEY_ENTER and not running: 
running = True # Start recording data 
sh.clear(@,255,0@) # Light up LEDs green 
# If we were already logging data, stop now 
elif event.code==ecodes.KEY_ ENTER and running: 
running = False 
gentle _close() 
# If we’re logging data... 
if runnane: 
# Read from acceleromter 


acc_X,acc_y,acc_z = [sh.get_accelerometer_raw()[key] for key in [ 


DE ge 72° | 
# Format the results and log to file 
logging. info( 
S{ci2 140i te) l2-1Of p42. Or) .fOnMatt d@G x, acC ). ace. Z))) 
print(acc_x,acc_y,acc_z) # Also write to screen 
except: # If something goes wrong, quit 
gentle _close() 
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Programs running in the terminal can 
be put to sleep by sending them to the 
background - from where they can 
easily be brought back with fg 


Keep an eye on your processes 
and you'll also be able to see 
what's hogging the Pi's CPU 
and memory resources 


OMMAND LINE P! 


As close to perfect as Raspbian is, things can go wrong. In this tutorial, 
we learn that there’s no need to turn the Raspberry Pi off and on again: 


Raspbian 
raspberrypi.org 
/ downloads 
- though most 
of the tutorial 
series will 
work with the 
command line 
running the 
Linux default 
Bash shell 

on any GNU/ 
Linux PC 


KEEP ON 
RUNNING 


nohup is 
useful fora 
program that 
will be running 
for some 

time in the 
background 

- perhapsa 
sensor project 
you're working 
on - until you 
feel happy 
enough to add 
it to Raspbian's 
startup 
processes. 
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just kill the process! 


ver lost the ‘off switch’ for a program? 
Sometimes software you’re running seems 
to have no inclination to stop: either you 
can’t find out how to quit, or the app has a problem 
and won’t respond to your q, CTRL+C, or whatever 
command should close it down. 

There’s no need to panic, and certainly no need 
to reboot: just identify the process and quietly kill it. 
We’ll show you how, and look at what else can be done 
with knowledge of processes. 


Processes 

Find the many processes running on your Pi with the 
ps command. On Raspbian, it’s usually called with 

the a and x switches which give all processes, rather 
than just those belonging to a user, the u switch shows 
processes by user, attaching it to a tty. wadds wider 
output, and ww will wrap over the line end to display 
information without truncating. 

Type ps auxww to see, then try with just a or other 
combinations. You’ ll notice that these options work 
without the leading dash seen for other commands. 
Both the lack of dashes, and the letters a and x, date 
back to the original Unix ps of the early 1970s; this was 
maintained through various revisions by one of Unix’s 
two family branches, BSD, and baked into the first GNU/ 
Linux ps. Unix’s other branch, System V, extended and 
changed ps with new options and new abbreviations for 
command switches, so for ps ax you may also see ps -e 
(or -ef or -ely to show in long format). 


The ps aux listing has various headers, including 
the USER which owns the process, and the PID 
(process identification number). This starts with 1 for 
init, the parent process of everything that happens in 
userspace after the Linux kernel starts up when you 
switch the Pi on. Knowing the PID makes it easy to kill 
a process, if it’s the easiest way of shutting it down. 
For example, to killa program with a PID of 3012, 
simply enter kill 3012. To quickly find the process 
in the first place, use grep on the ps list. For example, 
locating vi processes: 


ps aux | grep -i vi 


The -i (ignore case) isn’t usually necessary, but 
occasionally a program may break convention and 
contain upper-case letters in its file name. You 
can also use killal11 to kill by program name; for 
example, with killall firefox. 


Piping commands 
Naturally, you can pipe ps’s output to select the PID 
and feed directly to the kill command: 


kill $(ps aux | grep ‘[f]irefox’ | awk 
‘{print $2}’) 


We don’t have space for an in-depth look at awk 


(we’re using it here to print the second field of grep’s 
output, the PID), but the [f] trick at the beginning 
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Fig a htop tells you what's running, what resources it's using, and 
lets you interact with the process, even killing htop from within htop 


of Firefox (or whatever named process you want to 
kill) singles out the Firefox process. In the vi example 
above, grep found the grep process itself as well as vi 
(and anything with the letter sequence vi in its name). 

The output of ps also shows you useful information 
like percentage of memory and CPU time used, but it’s 
more useful to see these changing in real time. For 
this, use top, which also shows total CPU and memory 
use in the header lines, the latter in the format that 
you can also find by issuing the command free. For 
an improved top: 


apt-get install htop 


htop is scrollable, both horizontally and vertically, 
and allows you to issue commands (such as k for kill) 
to highlighted processes. When you’ve finished, exit 
both top and htop with q, although in htop you may 
care to practise by highlighting the htop process and 
killing it from there (see Fig 1). htop also shows load 
over the separate cores of the processor if you have a 
Pi 2 or 3. 


Background job 

Placing an ampersand after a command in the shell 
places the program in the background — try with: man 
top &and you’ll get an output like [1] 12768. 

The first number is a job number, assigned by the 
shell, and the second the PID we’ve been working with 
above. man top is now running in the background, and 
you can use the job control number to work with the 
process in the shell. Start some other processes in the 
background if you wish (by appending &), then bring 
the first - man top - to the foreground with fg 1. Now 
you should see man running again. 

You can place a running shell program in the 
background by ‘suspending’ it with CTRL+Z. fg will 
always bring back the most recently suspended or 
backgrounded job, unless a job number is specified. 
Note that these job numbers apply only within the 
Shell where the process started. Type jobs to see 
background processes; jobs -1 adds in process IDs 
(PIDs) to the listing. 
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Signals 
When we sent a kill signal from htop, we were given 
a choice of signal to send. The most important are 
SIGTERM, SIGINT, and SIGKILL. The first was the 
default when we killed from htop, and is the signal 
that kill sends if not called with a modifier. It tells a 
process to stop, and most programs will respond by 
catching the signal, saving any data they need to save, 
and releasing system resources before quitting. 

kill -2 sends SIGINT, the equivalent to stopping 
a program from the terminal with CTRL+C: you could 
lose data. Most drastic is kill -9 to send SIGKILL, 
telling the kernel to let the process go with no 
warning. Save this one for when nothing else works. 

Mildest of all is the Hang Up (HUP) signal, called 
with kill -1, which many daemons are programmed 
to treat as acall to simply reread their configuration 
files and carry on running. It’s certainly the safest 
signal to send on a critical machine. 


Staying on 

nohup will run a program which will continue after the 
terminal from which it’s started has closed, ignoring 
the consequent SIGHUP (hangup) signal. As the 
process is detached from the terminal, error messages 
and output are sent to the file nohup.out in whichever 
directory you were in when you started the process. 
You can redirect it, as we did in part 4 (issue 34), with 
1> for stdout and 2> for stderr; &> is a special case for 
redirecting both stdout and stderr: 


nohup myprog &>backgroundoutput.txt & 

One use of NOHUP for Pi users is to be able to set 
something in motion from an SSH session, that will 
continue after an interruption to that session. For 
example, restarting the network connection to which 
you are connected: 


sudo nohup sh -c "ifdown eth@ && ifup ethe" 


Note that the nohup.out log file created here will 
need sudo privileges to read — or reassign with: 


sudo chown pi:pi nohup.out 


= = a dd 
Filn Edit Tabs Help 


Above Everything running has a process ID (PID) that can be used 
to control that program; find them all with ps aux 
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QUICKER 
BOOT 


The startup 
process of 
Raspbian is 
controlled 

by SysvVinit, 
but like other 
GNU/Linux 
distributions 
will eventually 
change to the 
new, faster 
SystemD. 

This will 
change startup 
processes, 
but 
instructions 
here will still 
be relevant. 


KEEP ON TOP 


Using a virtual 
console, it 
can be worth 
keeping htop 
running so that 
if there are 
any problems, 
you can 
CTRL+ALT+Fn 
there fora 
quick look 

— even if the 
GUI freezes. 


LEARN TO 
LOVE THE 
COMMAND 
LINE 


With 


MagPi 


Now 

available at: 
raspberrypi.org 
/magpi 


wis 
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> Lisiparoi LED 
light ring 
(infrared version) 
magpi.cc/ 
1SQVFrW 


> Cyntech 
Raspberry Pi case 
magpi.cc/ 
1SQVGvW 


> Raspberry Pi NoIR 
Camera Module 


> USB WiFi adapter 


> MotionEyeOS 
magpi.cc/ 
1UCw1Jk 


> Drill and small 
drill bit (amm or 
2mm ideal sizes) 


> Small file (we 
used a metal 
nail file) 


> Pencilanda 
sharp knife (craft 
or Stanley knife) 
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WESLEY ARCHER 
(AKA RASPBERRY COULIS) 


i ~ 
Self-taught Raspberry Pi enthusiast, > ' 
guide writer for Pi Supply and creator of Ne ty, 
raspberrycoulis.co.uk. Enjoys trying out new ye h. 

Pi projects and sharing them! 
raspberrycoulis.co.uk / @RaspberryCoulis ty "3 


This is the Lisiparoi; it 
provides an infrared light 
source for the NoIR camera 


Inside the case is a Model B, 
the original Raspberry Pi 


RASPBERRY PI 


CAMERA HACK 


Have a spare Raspberry Pi Model B lying about? Turn it into a night-vision 
CCTV camera with this simple case hack... 


any people have a number of Raspberry Pis 

at home. Some might say those folks are 

obsessed, but Pis are so versatile that trying 
out new projects where possible is great fun! Putting 
them to good use is always exciting, so why not turn 
a spare Model B into a night-vision CCTV camera, 
using an inexpensive case, the Camera Module, and 
a nifty little accessory called the Lisiparoi to provide 
infrared lighting? If you saw the previous guide on 
adding push notifications to MotionEyeOS (issue 43), 
then combining this with night vision would be 
a great addition! 


Mark where you will cut 

Before cutting into the case, it makes things easier to 
mark it out first. Grab your pencil, place your Camera 
Module and Lisiparoi on the case, and then draw 
around them. You should be able to see the pencil 
line, and it’s easy to remove if you need to. Make sure 
you allow enough room around the outside so that it’s 
not too close to the edge of the case, though! You’1l 
also need to cut out space for the pins on the Lisiparoi, 
holes to mount the Camera Module board, anda hole 
for the camera lens itself. 
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>STEP-02 

Drill the mounting holes 

Using a small drill bit (42mm / 2mm is ideal), drill two 
small holes in the case. If you are very careful, you can 
use the Lisiparoi as a template. You should now have 
two small holes in the case and a pencilled outline 
of the Lisiparoi. It’s now time to drill holes for the 
header pins, which are a few millimetres away from 
the bottom edge of the Lisiparoi. It’s best to start 
small and increase the size of the holes as you go; 

it doesn’t have to be exact, as the Lisiparoi will hide 
everything once in place. 


>STEP-03 

Drill, file, test, and repeat 

Whilst doing this, remember — you can always 

cut more off! To make sure our header pins on 

the Lisiparoi fit nicely, we drilled the holes to the 
approximate width of the header and then used a 
small file to square off the holes. We then placed the 
Lisiparoi in place to see if it fit; if it didn’t, a little 
more was filed off until it did. It doesn’t have to be 
surgically accurate, since the Lisiparoi sits on top of 
the holes; even so, take your time, as you can’t undo a 
hole if it’s too big! 


>STEP-04 

Raspberry Pi NoIR Camera Module 

It’s now time to mark and cut a hole for the Camera 
Module. Again, we drew around the module witha 
pencil and then drilled small holes along the inside 
edge of the outline (otherwise the hole will be too 
big). Next, very carefully use a sharp knife to cut out 
the hole; the drilled holes along the outline should 
help with this step. Make sure this is done on a tough, 
steady surface (we used an old chopping board). Fine- 
tune the fit by filing the hole and testing that the 
Camera Module fits. Repeat until it does. 


As the old adage goes, ‘measure twice, cut once’. 
If in doubt, cut smaller and file away to fit 
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Left Once it's 
complete, you 
should hopefully 
see something 
like this from 
your Raspberry 
Pi night-vision 
CCTV camera! 


motionEye & 


MEASURE, 
THEN 
MEASURE 
AGAIN! 


They always 
say ‘measure 
twice, cut 
once’, and so 
do wel! It is 
better to be 
safe than sorry. 


>STEP-05 

Put everything together 

Now that the holes are all cut and fit nicely, it’s time 
to put everything together. Make sure you’ve soldered 
the header onto your Lisiparoi first, though! The 
header needs to be soldered so the pins are on the 
inside of the case and pointing downwards, so that 
the jumper cables can be fitted to the Pi’s GPIO once 
fully assembled. Screw your nuts and bolts together 
and connect up your cables, including the ribbon 
cable for the Camera Module. For more information 
on using the Lisiparoi, including wiring diagrams, 
check out the official site here: magpi.cc/1SQWvoo. 


>STEP-06 

Install MotionEyeOS and test everything 

If you have connected the Lisiparoi so that it turns 
on whenever the Pi does, then you just needa 

CCTV operating system. MotionEyeOS is perfect 

for this, because it’s simple to use and works 

very well! Download the relevant image from 
magpi.cc/1UCw1Jk, then write it to your SD card. You 
won’t be able to see if the infrared LEDs are on, but 
test it out in the dark and you should see more than 
you would normally without them! As the LEDs are 
small, they’re not very powerful, but should provide 
enough illumination to see better in the dark! 


LESS IS 
MORE 


You can always 
cut more, but 
you cannot 
replace what 

is gone. Think 
about this 
when drilling 
and filing! 
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A bar chart 


shows the audio 


frequencies 


Built on stripboard, the 
Spectrum visualiser 
features four chips 


> 2x MSGEQ7 
equaliser chip 


> 1x MCP602 
operational 
amplifier 


> 1x MCP3002 
2-channel, 10-bit 
A/D converter 


> 4x 8-pin DIL 
sockets 


> 2x 3.5mm board 
mounting stereo 
jack sockets 


> 1x 28-hole by 19- 
hole stripboard 


> 1x 26-way GPIO 
header socket 


> Assorted 
resistors, 
capacitors, 
and wires 
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Turn any sound source into a stunning graphics display 


onverting sound to lights has always been a 

popular project, although there is little in the 

way of Raspberry Pi versions, so this month 
we thought we would remedy that. This project uses 
the popular MSGEQ7 chip, which is officially obsolete 
but still widely available. This chip has seven second- 
order, switched capacitor, analogue filters built into 
it that cover the audio spectrum. These filters peak at 
65Hz, 160Hz, 400Hz, 1kHz, 2.5kHz, 6.25kHz and, for 
those youngsters still lucky enough to hear that high, 
16kHz. The frequency response is shown in Fig 1 (page 
64); note that both the frequency and the output are 
plotted on a log scale. This ensures that the response 


looks like it sounds, because of our logarithmic 
sensing of both frequency and loudness. 

The actual peak frequency of each filter depends 
on the built-in oscillator that is set with an external 
resistor and capacitor, 200kQ and 33pF respectively. 
The chip takes in an audio signal and passes it through 
these seven filters. However, the chip has only one 
output: it’s an analogue signal that gives the output of 
each filter in turn, as you feed it clock pulses. The fact 
that the Pi has no built-in analogue input is probably 
why there’s not many Pi projects using this chip. 
To get round this, we used the MCP3002 chip that 
featured in last month’s project. 
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The hardware 

As we wanted a stereo display, we used two of these 
MSGEQ7 chips, one for left and the other for right. 
We found that the MSGEQ7 chip required an audio 
input of about 0.6V PTP (peak-to-peak) to get the full 
output signal, and while that could be provided by an 
iPad going absolutely full blast, the audio signal from 
the Pi itself was not so large. Therefore we decided 

to put a x10 amplifier between the audio source and 
the MSGEQ7. We had two audio jack sockets wired in 
parallel so the spectrum board could be used in pass- 
through mode. That is, the audio input was connected 
to one socket and the other socket could be connected 
to your headphones or input to your audio amplifier / 
speaker system. As the MSGEQ7 is capable of being 
run at 3V, this made the interfacing of the digital 
clocking signals easy. Each MSGEQ7 is fed into a 


separate input channel of the MCP3002 A/D converter. 


The full schematic is shown in Fig 2. 

The MCP602 has, conveniently, two amplifiers in 
it with a close to rail-to-rail output, and will work 
off a single 3V rail. If you are substituting other 
operational amplifiers here, make sure that they meet 
that specification. The gain of 10 is given by the 10kQ 
resistor between pins 1 & 2 for the right side and pins 
6 & 7 for the left side. If you need to increase the gain, 
just increase this resistor value; for example, a 47kO, 
resistor will give a gain of 47 times. As the amplifiers 
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GPIO 24 


Output 


GPIO 10 
GPIO 9 


GPIO 11 
GPIO 8 


Gnd 


Strobe 


Fig 2 The 
schematic of the 
Spectrum board 


are running off a single rail, you need to generate a 
virtual ground; luckily this is generated on pin 6 of 
the MSGEQ7. The 16uF input capacitor value is not 
very critical, and you could use anything between 
10uF and 100uF here. 

The strobe and reset pins for producing the different 
filters’ output from the chip are directly connected 


As we wanted a stereo 
display, we used two of 
these MSGEQ7 chips 


to the GPIO pins. The MCP3002 is connected to 

the SPI bus, just like last month’s project. Full 
construction details are given in the step-by-step 
section (pages 62-63). Note that if you’re trying to 
adjust the 200kQ. resistors and 33pF capacitors to give 
you a 165kHz oscillator exactly, you can’t just put an 
oscilloscope on pin 8. This is because the capacitance 
of most affordable oscilloscope probes will become 
part of the oscillator circuit and change the frequency. 
You need to measure that the frequency of a channel 
peak is correct, to make sure the oscillator is at the 
correct frequency, but this is not too critical. We 
would advise you to study the data sheet of this chip. 
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Underside of Board 


XK orill 1mm hole 


The software >STEP-01 


As well as having WiringPi installed, you need to Preparing the stripboard 
enable the SPI drivers — see last month’s project for The diagram shows the strip 
details if you haven’t already done this. The software side of the board. Take a piece 
in the Spectrum.py listing (pages 64-5) is written in of 28- by 19-hole stripboard and 
Python using the Pygame framework. It can run in drill four 3mm holes in each 
debug/full-screen mode or in whole-screen mode. The corner, one hole down and in 


from each corner. Next, drill six 


full-screen mode still has the window bar and icon 
bar visible, whereas whole-screen has nothing but the 
display. However, any Python error that occurs in the 
full-screen mode could lock up your system, So set it cattel hic Ten H ren Rewer eh 
to debug mode to begin with. When not in the debug fener orhor CC IeEtnGE 
mode, the display can be toggled between full-screen we used. Finally, cut the strips 
and whole-screen with the space bar. This is useful if in the position indicated by the 
you’re using the Pi as a source of the audio, to allow grey rectangles. 

you to change tracks and make a playlist. We used VLC 
for this, but there are other audio players available. 


1mm holes where the black holes 
are, to accommodate the two 
stereo jack sockets. The position 
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>STEP-02 
Building the stripboard 


This diagram shows the component side 
of the boards with the strips shown as 
hidden details. Use solid copper links 
for the straight jumpers and then add 
the IC sockets. Fit the resistors and 
capacitors. Note the ceramic capacitors 
all fit on adjacent tracks, so you can 

use surface-mount capacitors on the 
underside of the board if you want. The 
200kQ resistor was formed by standing 
up two 100kQ resistors and connecting 
the tops; this is because we didn't have 
any 200kQ resistors to hand, although 
you can get away with one here. Finally, 
place the flexible wires on the board. 


>STEP-03 

Attaching to the Pi 

The photograph shows the finished 
board. All that remains is to attach it 

to the GPIO pins of the Pi. There are 
many ways to do this; we used a 26-way 
header so that it would fit on any Pi. We 
used 30cm of eight-way ribbon cable to 


attach the header to the Spectrum board. 
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Tutorial 


GPIO 23 
GPIO 24 
GPIO 11 

GPIO 09 
GPIO 10 
3V3 


GND 
GPIO 08 
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Tutorial WALKTHROUGH 


Spectrum.py 


OL; 
02. 
03. 
04. 
05. 
06. 
07. 
038. 
09. 
On 


i bale 


Ze 
dK 


14. 


# Spectrum - Sound visualiser 
# By Mike Cook - April 2016 


import pygame, time, os, random 
from pygame.locals import * 
import wiringpi2 as io 
pygame.init() # initialise graphics interface 
pygame.mixer.quit() 

pygame.mixer. init ( 

frequency=22058, size=-16, channels=2, buffer=512) 
enclosureSound= [ pygame.mixer.Sound( 
“sounds/"+str(c)+".ogg") for c in range(@,1@) | 


debug = False 
# debug with window bar, display numbers and raw data 
screen = pygame.display.set_mode((@, @)) 


# with window bar - use for debugging 


Soir 
34. 
Elem 
36, 


37. 
38. 
39. 
40. 


41. 
42. 
43. 
44. 
45. 
46. 
47. 
48. 
49. 
50. 
bas 
27 
Do. 
54. 
55. 
Do} 
a7. 
Do. 
Doe 
60. 
61. 
62. 
63. 
64. 
65. 
66. 
67. 
68. 
69. 


random. seed() 

leftData = [ 6,7,8,90,80,70,60 | 

[ 60, 70,80,90,80,70,62 | 

colour = [(255,0,0),(255,64,0) , (128, 255,@) ,(255,255,0), ( 
@,114,141), (18,0, 237), (255,0, 255) ] 


rightData = 


if debug : 

noiseFloor = [[0,0,0,0,0,0,0],[0,0,0,0,0,0,0] ] 
else : 

noiseFloor = [|57, 55, 58, 60, 71, 103, 124], | 


47, 72, 85, 86, 101, 136, 201]] 
rawData = [[0,0,0,0,0,0,0],[0,0,0,0,0,0,2]] 


textHeight = 36 
font = pygame.font.Font(None, textHeight) 


def main(): 
initGPIO() 
while True: 
checkForEvent( ) 
getSpectrumData() 
plotData() 


def getSpectrumData(): 

# set up the chip to read in the data 

global leftData, rightData 

io.digitalWrite(pinReset, 1) 

io.digitalWrite(pinClock, 1) 

time.sleep(@.201) 

io.digitalWrite(pinClock, 0) 

time.sleep(@.901) 

io.digitalWrite(pinReset, 0) 

io.digitalWrite(pinClock, 1) 

time.sleep(@.204) 

# now read in each channel in turn 

for s in range(@,7): 
io.digitalWrite(pinClock, 0) 
time.sleep(@.004) # allow output to settle 
leftData[s] = 
rightData[s]= scaleReading(io.analogRead(71),s,1) 


scaleReading(io.analogRead(7@),s,0) 


Fig 1 The frequency 
response of the 
MSGEQ7 chip 


ZY 


Frequency Responce Log Hz 


15. xs, ys = screen.get_size() 
16. fullScreen = False 
17. if not debug : 
iS, pygame.display.toggle fullscreen() 
19. fullScreen = True 
20. else : 
pa ys -= 66 
22. pygame.display.set_caption("Spectrum Sound Show") 
25, 
24. posX = xs / 16 
25. backl = pygame.Surface(screen.get_size()) 
26. errase = pygame.Surface(screen.get_size() ) 
27. 
28. pygame.event.set_allowed(None) 
29. pygame.event.set_allowed([pygame.KEYDOWN, pygame. QUIT ] ) 
30. 
31. pinReset = 23 
32. pinGlock — 24 
20 
Output dB 
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SPECTRUM SHOW 


70. io.digitalWrite(pinClock, 1) 103. 
7A 104. def initGPIO(): >PYTHON 2.7 
72. def scaleReading(reading, band, side): 105. try : 
Fee # adjust for screen size and noise floor 106. io.wiringPiSetupGpio( ) DOWNLOAD: 
74. global rawData 107. except : WEL |SIEE/L TUN 
75s if debug : 108. print"start IDLE with 
To rawData[side][band] = reading ‘gksudo idle' from command line" vIGEGed 
WT. reading -= noiseFloor|[side][ band] 109. os._exit(1) 
78. if reading <0 : 116. io.pinMode(pinReset, 1) Check out Mike's 
79. reading = @ ihilale io.pinMode(pinClock,1) Bakery videos at: 
; ; magpli.cc/1NqJnIz 
80. scaled = (float(reading) / ( d Fe io.mcp3002Setup(70,2@) 
1024.08 - float(noiseFloor[side][band]))) * ys a Ie 
81. return int(scaled) 114. def terminate(): # close down the program 
82. LTS: print ("Closing down please wait") 
83. def plotData(): TG. if debug : 
84. # display volume bars a Fi print rawData 
85. global leftData, rightData 118. pygame.quit() # close pygame 
86. pygame.draw.rect(screen, (0,0,0),(0,8,xS,ySs),®) 119, os._exit(1) 
8/7. for band in range(@,7): 120. 
88. pygame.draw.rect(screen, colour[ 121. def checkForEvent(): # see if we need to quit 
6-band], ((band+1)*posX, ys-leftData[6-band],posX-20,ys),@) 122. global fullScreen 
89. pygame.draw.rect(screen, colour[ band], (( 123, event = pygame.event.poll() 
band+8 )*posX, ys-rightData[ band], posX-28,ys),@) 124. if event.type == pygame.QUIT : 
o0r if debug : 125% terminate() 
SH drawWords(str(leftData[6-band]),(band+1)*posx,@) 126. if event.type == pygame.KEYDOWN : 
92. drawWords(str(rightData[band]),(band+8)*posx,@) 12/7. if event.key == pygame.K_ESCAPE : 
25. pygame.display.update() 123. terminate() 
94. 129) if event.key == pygame.K_ SPACE and not debug: 
95. def drawWords(words,x,y) : 130. pygame.display.toggle fullscreen() 
96. textSurface = pygame.Surface(( 3a, fullScreen = not fullScreen 
len(words )*12, textHeight ) ) £327 
97. textRect = textSurface.get_rect() 133. # Main program logic: 
98; textRect.left = x 134. if name == ~ Main: 
O°: textRect.top = y 13 bey 
100. pygame.draw.rect(screen, (81,133,133), ( LG. main() 
x,y, len(words)*12,textHeight-10), @) 137. except: 
101. textSurface = font.render( 138. if fullScreen : 
words, True, (180,180,180), (81,133,133)) 139) pygame.display.toggle fullscreen() 
102. screen.blit(textSurface, textRect) 140. 


The display we chose to implement is a simple bar 
display with the left channel as the mirror image of 
the right one. This means that the lowest frequency 
is at the centre of the screen, and the highest at the 
edges. The colour of each bar is set by the colour list of 
RGB tuples. As the program can be run on any size of 
window, everything is worked out from the screen size 
once the full-size window has been created. 

With any analogue system there’s always noise; the 
display looks better if no sound equals no display. To 
do this, there is anoiseFloor list of values for each 
side that’s subtracted from the MSGEQ7’s readings 
before display. This is initially set to all zero values, 
but when you quit from the debug mode, a list of the 
output values is printed. If you quit with no audio, 
these values can be pasted directly in the code that 
sets the noiseFloor list for the non-debug mode. 
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Taking it further 

We found it best to use an external sound source such 
as an iPad, so that you can easily trim the volume to 
compensate for quiet or noisy music. We found that 
the best type of music was any with a good dynamic 
range and beat. 

With regards to altering things, the simplest thing 
you can do is to change the colours of the bars and 
the way they’re displayed. For example, the colours 
could change as the bars get higher. However, you 
might want to take it further and change the way 
the amplitude values are displayed. They could be 
used to control the drawing of an abstract figure or 
an animation. The display or the colours could be 
made to change after a set time. Alternatively, you 
could drive a string of NeoPixels to generate a bright 
external display. 
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The Wii Balance Board 
is a Bluetooth scale 
that can be controlled 
from a Python script 


1 me Bs ie > ene bee a 
in & 1 & Gr | 
j AN | 4 all | By | | on | = | 
= ~ | a | & f 
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Weight measurements Asnarky yet 


are sent to your informative SMS is 
dashboard on Initial sent every time you 
State's website weigh yourself 


JAMIE BAILEY 


Jamie is an electrical/system engineer, 
integrated circuit designer, and CEO/ 
founder of Initial State, a data analytics 
service for Internet of Things devices. 
initialstate.com 


+1 (615) 823-2279 


If you are what you eat, perhaps you should eat a 
skinny person. yg You gained 0.5 Ib since last ... 


BUILD A WEIGH I- TRACKING 


> Wii Balance 
Board 

> Wii Fit 
rechargeable 
battery pack 


> % Felt pads 


> Pencil 


The Wii 

Balance Board 
pairs with your Pi 
through Bluetooth, 
making it easy to 
read your weight 
with a script 
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Connect a Set of scales to the web that tracks your weight 
and sends you text message updates with an attitude 


h, that boring, soulless bathroom scale. 

We love to hate you when you don’t show 

us that number we want. We swear at you, 
as if you’d care. Why hasn’t anyone made a scale 
that’s actually fun to use? It’s time to create a scale 
that’s not only smart, but has a bit more personality 
to brighten your day. We’re going to build our very 
own hackable, weight-tracking, text-messaging 
bathroom scale that comes with a built-in sense 
of humour. 


Setting up the Wii Balance Board 
As the Raspberry Pi 3 comes with Bluetooth built 
in, it makes it very easy to communicate with the 
Wii Balance Board. If you have a Raspberry Pi1 
or 2, you’1l need to use a USB adapter such as the 
inexpensive iAnder USB Bluetooth 4.0 Low Energy 
adapter (magpi.cc/1NqI6m)}). 

Power on your Pi and open up a terminal window. 
You can see the address of your Bluetooth dongle by 
entering the following command: 


hcitool dev 


Install the Bluetooth modules that we will be using 
in our Python scripts: 


sudo apt-get install python-bluetooth 
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Settings cf? [e]) (--\- = * my weight history support jamie@initialstate 


Data Triggers Sharing # Edit Tiles 03/06/2016 03:12 AM : 03/18/201604:12 AM 


a —— 


Mon? Wed OF Thu 10 sat 12 Mar 13 Mon 14 Tue 15 Wed 14 Thu 1? 


Update match lb 


[]) +19999999999 


lf you are what you eat, perhaps you should eat a skinny person. @ You gained 0.5 Ib since last time (189.5 | 


a 


Manage All Trigger Contacts 


03/18/16 8:12 AM 


Set up SMS notifications and track 
your weight over time in Initial 


State's web-based dashboard 


After installation completes, we’re ready toconnect successful, you’1l see something similar to the 


and communicate with the Wii Balance Board. We following on rhe screen: INITIAL 
won’t be permanently pairing our Board with our Pi, STATE 
like we do with most of our Bluetooth devices. The Wii Found Wiiboard at address 
Balance Board was never intended to be paired with 00: 23:CC:2E:E1:44 
anything other than a Wii. Pairing will happen every Trying to connect... 
time we run our Python script. Connected to Wiiboard at address 

It’s time to connect our Wii Balance Board to our QO: 23:CC:2E:E1:44 
Raspberry Pi. We’1l do this by running a Python script. Wiiboard connected 
To get the scripts we’ll use for this project, clone the ACK to data write received 
GitHub repo: 84.9185297 lbs 

84.8826412 lbs 

cd ~ 84.9275927 lbs 

git clone https://github.com/InitialState/ 
smart-scale.git You have now successfully converted your Wii 

cd smart-scale Balance Board into a Raspberry Pi-connected scale. 

ls Now, let’s make it a cool scale. 
You should see two Python files in the new Create a hacky lever to access the sync 
smart-scale directory: smartscale.py and Sls OE lessee en ee etre 


ba a ; using a pencil and a few %' felt pads 
wliiboard_test.py. Run the wiiboard_test.py script 


to test communication and take weight readings 
from the Wii Balance Board: 


sudo python wiiboard_test.py 
You’ ll see the following response: 


Discovering board... 
Press the red sync button on the board now 


Remove the battery cover underneath the Wii 
Balance Board to locate the red sync button. Make 
sure that you press the button within a few seconds 
of running the script or a timeout will occur. Once 
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Tutorial WALKTHROUGH 


Initial State 


We want to stream our weight/data to a cloud service 
and have that service turn our data into a nice 
dashboard that we can access from our laptop or 
mobile device. Our data needs a destination; we’ll use 
Initial State as that destination. 

Go to magpi.cc/1TFlhaz and create a new account, 
then install the Initial State Python module onto your Pi: 


cd ~ 
\curl -sSL https://get.initialstate.com/ 
python -o - | sudo bash 


When prompted to automatically get an example 
Script, type Y. This will create a test script that we can 
run to ensure that we can stream data to Initial State 


Above TheWii Hardware tweaks from our Pi. Run the test script to make sure we can 
Fit rechargeable ba 
batterypack Nintendo assumed you would always power your create a data stream to your Initial State account: 
allows youto Wii Balance Board with four AA batteries and so 
constantly power __. ; 
your scale from included no AC power adapter. Having only battery python is_example.py 


awalloutlet,to power would be inconvenient because we cannot 


avoid having to 


permanently pair our Wii Board to our Pi through 


do a Bluetooth Go back to your Initial State account in your web 
sync each li Bluetooth. We need to sync it, then allowit toremain — browser. A new data bucket called ‘Python Stream 
you weig 


ADD YOUR 
OWN HACKS 


You can 
modify the 
messages that 
get sent, the 
units used for 


measurement, 
and even add 


your progress 
toward your 
own weight 
loss goals by 
modifying 
the existing 
Python script. 
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Right Receive a 
variety of funny, 
inspiring, and 


synced without draining the batteries, so that we can 
simply step on the scale and weigh. Luckily, there are 
several third-party adapters made for the Wii Balance 
Board that we can use to provide constant power from 
a wall outlet. The Wii Fit Rechargeable Battery Pack 
(magpi.cc/1NqIEIT) is a perfect solution to our power 
problem. Replace the batteries with this battery pack, 
and plug the AC adapter into a wall outlet. 

Having to pair the Wii Balance Board and Raspberry 
Pi every time we run our Python script presents 
another inconvenience due to the location of the 
sync button. The sync button is at the bottom of the 
Wii Board, which means we would have to flip it over 
every time we sync. We can fix this by making a hacky 
little lever using a pencil and three %” felt pads. The 
rechargeable battery pack exposes the sync button to 
the underneath surface of the Board. Tape a pencil (or 
something similar) that runs from the sync button 
to the outside front of the Board. Stack three %’" felt 
pads (or something similar) on the centre(ish) of the 
pencil to create a stationary pivot. Flip the Board over 
and you can press the sync button by simply pressing 
down on the lever. Hacky but effective. 


Example’ should have shown up on the left in your 
bucket shelf. Click on this bucket and view it in the 
visualisation apps Tiles, Waves, and Lines. 

You are now ready to start streaming real data from 
your scale. 


The final script 

The final script that puts everything together is called 
smartscale.py, in your ~/smart-scale directory. A few 
settings need to be set in the script before you can run 
it. Open up smartscale.py in your favorite text editor, 

such as nano: 


cd ~ 
cd smart-scale 
nano smartscale.py 


Near the top of this file, there is a User Settings 
section. These are all of the settings that you can 
tweak to your taste. The only setting you have to set is 
your ACCESS_KEY, which is your Initial State account 
key. If you don’t put your ACCESS_KEY in this field, 
your data won’t show up in your account. Go to your 


Trigger: ‘Update’ was "You gained 0.85 


Ib since last time (191.45 Ib). You 
probably just forgot to go to the gym. 


Trigger: ‘Update’ was ‘| enjoy long, 


Trigger: 'msg' was "You are in shape ... 
round is a shape @. You gained 4 Ibs. 


insulting SMS romantic walks to the fridge. 191.3 Ib That *s like what, 8 years in a row now? 
messages from (-0.13 Ib change)' 2a 
your smart scale Trigger: ‘Update’ was 'Guys that wear 
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Trigger: ‘Update’ was "You ‘re getting so 


skinny that if someone slaps you, they ‘Il 
get a paper cut.“ You lost 4.61 Ib 


since last time (171.67 Ib): last time (193.38 Ib). 


Trigger: 'Update’ was "How do | like my 
eggs? Umm, ina cake. — You weigh 
192.07 Ib!" 


Trigger: 'Update' was ‘After exercising, | 
always eat a pizza ... just kidding, | don’t 
exercise. @ You gained 1.34 Ib since 


Trigger: ‘Update’ was "Il know milk does a 
body good, but damn, how much have 
you been drinking? © You lost 1.32 Ib 


skinny jeans took the phrase, getting 
into her pants, the wrong way. fl You 
weigh 191.1 Ib!" 


Trigger: 'Update' was ‘If you were words 
on a page, youd be what they call FINE 
PRINT! LJ You lost 1.09 Ib since last 
time (153.58 Ib).’ 


since last time (75.04 Ib).' 
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Tutorial 


% 
a Example Log 


Value 


Luckily, there are several third-party adapters 
made for the Wii Balance Board that we can use 


Stream Done 


_ mM 
« () C) ®) () python stream example 


Value 


true 


Count 


DO 


19 


1/19 


Run atest 
script from your 
Pi to make sure 
you can create 
a data stream 
to your Initial 
State account 


to provide constant power from a wall outlet 


Initial State account in your web browser, click on your 
user name in the top-right, then go to ‘My Account’. 
You’ ll find your access key at the bottom of the page, 
under ‘Streaming Access Keys’. 

Once you have specified each parameter in this 
section and saved your changes, you’re ready to run 
the final script: 


sudo python smartscale.py 


Step on the scale to take a measurement. Go to your 
Initial State account and click on the new data bucket 
with the name corresponding to the BUCKET_NAME 
parameter (i.e. My Weight History). Click on Tiles to 
view your weight history dashboard. You can customise 
your dashboard by resizing and moving tiles, as well as 
changing view types and even adding tiles. 


SMS setup 


Let’s create a SMS alert whenever the scale takes a 
weight measurement. First, make sure your weight 
history data bucket is loaded, then click on the 
bucket’s settings in the data shelf (under its name). 
Click on the Triggers tab; if you don’t see a Triggers 
tab, make sure you’re subscribed to an Initial State 
account plan that allows Triggers. 

Select the data stream to trigger on; you can use 
the drop-down list to select from existing streams 
once a data bucket has loaded, or you can type in the 
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stream name/key manually. Select the ‘Update’ data 
stream and then select the conditional operator, in 
this case ‘match’. Select the Trigger value that will 
trigger an action (manually type in the desired value). 
Type in lb if you are using imperial units, or type in kg 
if you are using metric units. Whenever the Update 
stream contains ‘lb’ (or ‘kg’), you will get a text 
message notification. 

Next, click the ‘+’ button to add the Trigger 
condition. Select the action (‘notify by SMS’) and 
then click the ‘+’ button to add the action. Input any 
verification code, if adding a new phone number, to 
complete setup. 

Your trigger is now live and will fire when the 
condition is met. Click Done to return to the main 
screen. Every time you weigh yourself, you will get 
an SMS that contains your weight, how much it has 
changed since the last measurement, and a random 
joke, insult or compliment. 


ADD MORE 
DATA 


Customisation 

Not a fan of the humour built into this project? You 
can change the jokes in the messageWeighFirst, 
messageWeighLess, messageWeighMore, and 
messageWeighSame functions to whatever wacky 
brand of humour you have. You can also stream data 
from other sources into the same weight history 
dashboard to create your own personal health 
dashboard. Hack away. 
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Tutorial 


A disassembled USB power 
bank provides power and 
can be easily recharged 


The Slice of Radio transmits 
messages over the Pi's serial 


> Large RC car 
controller 


> Slice of Radio 
magpi.cc/ 
1W7Sphx 


> XINORF 
magpi.cc/ 
1QSdoyo 


> USB power bank 
magpi.cc/ 
1W7UZE6 


> Toggle switch 
magpi.cc/ 
1W7VPkL 


> Hook-up wire 


> Micro USB cable 


PREVENT 
SHORT 


CIRCUITS 
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JAMES LACEY 


15-year-old Raspberry Pi 
enthusiast and Lego lover. He 
often makes projects using both. 
jameslL.tk 


WITH PI ZERO 


Control an Arduino- powered custom Lego car with a simple 
remote control and a Raspberry Pi Zero 


ver wanted to use a Raspberry Pi to remotely 

control an Arduino, but using something 

smaller and more portable than a keyboard? 
Here we’ll show you how to add a Pi Zero and wireless 
radio to acontroller from an RC toy, turning it intoa 
versatile and customisable project controller! 


Prepare the controller 

Open up the controller by removing any screws 

and plastic retention clips. Locate and remove the 
main PCB of the controller. You will see contacts 

on the PCB, which the joysticks or buttons on the 
controller touch to send signals to the integrated 
circuit (IC) on the board. Using a multimeter, you 
should be able to follow each contact to a pin on 

the main IC. On this controller there are four contacts, 
so four IC pins should be found and labelled. 


Remove the main IC 

The IC will probably be soldered to the PCB, so cut off 

all the legs with pliers and desolder all the legs from 

the board. Now is also the time to remove other large 
components from the PCB that may interfere with the 
placement of the Pi Zero. Remembering which pin hole 
connects to which IC, solder differently coloured wires 

to each hole and the other half of the contacts (which 
are usually connected via a common trace). It’s now time 
to prepare the Pi Zero. 


Preparing the Raspberry Pi 

Solder on only the first ten pins of a male GPIO 
header to the Pi Zero, so the serial pins are populated 
with connectors. Leave the rest of the GPIO holes 
unpopulated so you can solder on the pin connectors. 
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HACK A REMOTE CONTROL 


Prepare a microSD card with Raspbian Jessie Lite on it, contr: ol.sh 


then connect to an HDMI monitor, mains power, anda 
keyboard to run raspi-config. Next, get the code from #!/bin/bash 


the GitHub repository (magpi.cc/1QSep84) and place it fe Bei Yee Ode AU Ae Gabe agent, Porc Xecutey ck cok DOWNLOAD: 
; mount /dev/mmcb1lk@p2 / -o remount,ro # prevent SD magpi.cc/1QSep84 
in your home directory. : 

card corruption by mounting read-only 


mount proc /proc -t proc # as this is executed just 


>STEP-04 after the kernel has finished booting, /proc doesn't exist. This creates it. 
Wiring up the Pi tvservice -o # Turn off HDMI 

If you are using the code without alterations, solder stty -F /dev/ttyAMA@ 9600 # set the baudrate of the Slice of Radio 

the contact for the forward position to GPIO 27, the BPA Cire (OG. COMI dt cele neu ner seer ue ee 


gpio -g mode 22 down 
gpio -g mode 23 down 
gpio -g mode 24 down 


backward contact to GPIO 22, the right contact to GPIO 
23, and the left contact to GPIO 24. Connect the other 


half of each contact to a3.3V pin. Bend over the wires TTY=/dev/ttyAMA@ 
so they are as flush with the PCB as possible, so you while true; do 
can still attach the Slice of Radio transceiver. Turn A=0 

on the Pi and run the code; the HDMI monitor should ~ 


display no signal, and the LEDs on the Slice of Radio 


D=@ 
should flash when you move the levers. 


[[ $(gpio -g read 27) == 1 ]] && A=1 # forward 
[[ $(gpio -g read 22) == 1 ]] && B=2 # backward 


>STEP-05 [[ $(gpio -g read 23) == 1 ]] && C=4 # right 
Running the code at boot [L $(gpio -g read 24) == 1 ]] && D=8 # left 
Edit the /boot/cmdline.txt file to include the line SWSTATE=$ ( ($A+$B+$C+$D) ) 
"init=/home/pi/filename-of-code.sh". Verify a SEUSS ei 
that the code 1s correct and chmod = the a This echo "aAASTOP----- "> $TTY # stop and center, as there is no input on any switch 
is your last chance to change anything — the Pi will echo "aAACENTER---" > $TTY 
not boot to a terminal again without manual editing sleep @.5 
of cmdline.txt. Disconnect your HDMI monitor Re 
and keyboard, then reboot the Pi Zero. The LEDs on 1) 
the Slice of Radio should flash to show that data is a 

echo "aAACENTER---" > $TTY 


being transmitted. 


2) 
>STEP-06 echo “aAABACKWARD-" > $TTY 


Fitting the Pi in the controller echo "aAACENTER---" > $TTY 
You may have to use a Dremel tool or wirecutters/ 33 
pliers to remove parts of the internal structure of the 4) 

echo "aAASTOP----- = ey, 


controller, so that the Pi fits. We had to remove most 


of the battery compartment. After fitting, check that oP a Oy 
all the wires are still securely attached to the Pi and 5) 
the controller. Test the controller again, ensuring the echo "aAAFORWARD--" > $TTY 
LEDs flash. You’ve completed most of the controller, echo "aAARIGHT----" > $TTY 
but if you have sufficient space available, continue to i 

6 


the next step to get rid of that annoying power cable. 
echo "aAABACKWARD-" > $TTY 


>STEP-07 echo "aAARIGHT----" > $TTY 


Fitting the battery 8) 
Prise the two halves of the power bank apart with echo "aAASTOP----- > Sia 
a knife or screwdriver. You should see a cylindrical echo “aAALEPT=s-—= | > diy 
battery and a small PCB with a USB and micro 33 STRENGTHEN 
USB socket. Remove these from the housing and ae ee een WEAK 
--" > 
desolder the large USB socket from the board. ceca , SOLDER 
_ echo "aAALEFT----- Pe Diy JOINTS 
Using a multimeter, find and label the positive pad . 
that the USB socket was soldered to. Cut off the large 10) Use glue to 
USB plug from the micro USB cable, then solder the echo "aAABACKWARD-" > $TTY strengthen 
red wire to the positive pad and the black wire toa echo "aAALEFT----- pe aN weak solder 
el ae iy ‘tch h h a 3; joints that 
terminal o t e switch. Connect the other termina e may break off: 
to the negative pad ae BOY Cen aeeng, tt tae echo "DEBUG: $SWSTATE" # print to a debug terminal if cine 
controller for the micro USB connector and glue hepa oS en. vinqonn we tion feicuc ain 
it in place. You’re done! . 
esac 
done 
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SET UP & USE THE 
RASPBERRY PI! 


ORACLE 


WEATHER sIATION 


The new weather station kit is making its way 
to schools — here’s how to set it up, plus a 
taste of what you can do with it... 


ast month in The MagPi, 
we reported on how the 
long-awaited Raspberry 
Pi Oracle weather station was 
making its way to schools, with 
an initial shipment going out to 

a select few in the UK. Since then, 
more have been sent out and 
more schools have been receiving 
them, ready to do some weather 
science using the power of a little 
Python code. 

We’ ve put together a little 
euide based on the information 
freely available from the 
Raspberry Pi resources website 
(magpi.cc/1qEg9Nh), to help you 
build your station and then use 
it to take some measurements. 

In the future, hopefully, more 
people — not just schools — will 
be able to take advantage of 
the educational potential of the 
weather station kit. 
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BUILD YOUR 
WEATHER fae 
STATIO 


Grab a screwdriver and let’s get constructing! 


ALTERNATE 


01 - ATTACH THE HAT 


The coin cell battery 
needs to be inserted 
into the HAT while you're 


attaching it to the Pi The weather station is made up primarily of a HAT (which 


is two boards that can split up if needed) and sensors. We 
begin by attaching the HAT to the Raspberry Pi; first, add 
the GPIO extender and then screw in the spacers on the 
Raspberry Pi, as shown in the image. Once they're secure, 
align the HAT on top in the orientation shown and then 
screw it to the spacers. Finally, insert the battery. 


O02 - CONNECTING THE BOARDS 


GPIO pins can 
reach the HAT 
once attached, 

an extender is 
included which 
should be attached 
before screwing 
the HAT into place 


The weather station HAT is made up of two pieces: the 
weather board, which is the main HAT, and the air sensor 
board. They're not actually connected by any circuits, 
because you can have them separate for specific uses. 


So, to get them to communicate, you need to use an RJ11 
cable and insert it into the ports shown in the image. 


The cable allows for data 
to be communicated between 
the air sensor board and the 

I F 

e main weather board 


Raspberry Pi 


] 

] 

; The spacers keep the 
A HAT fixed above the 


raspberrypi.org/magpi June 2016 MdgPi | 73 


feature 


O03 - SENSING TEMPERATURE 


The temperature sensor is attached to the air sensor 
portion of the board via the remaining port. The cable 
allows it to be placed away from the Raspberry Pi. 


temperature 
probe that can 
be used outside 
for sensing 
weather, or 
elsewhere if you 
have a different 
use in mind 


06 - POWER AND NETWORKING 


Now that the weather station is constructed, you can 
provide it power and networking; find a spot where 
the cables will reach both power and a router and 
attach the final cables as shown in the diagram. The 
splitter cables can only go one way round, so there's 
no chance of getting it wrong! 


@ The Ethernet cable lets you power the weather 
, station and give it network capabilities, thanks 
' to Power over Ethernet (PoE) 
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04 - WIND SENSORS 


The wind-speed sensor is the 


device with the three ‘cups’ on 


The anemometer, or wind-speed 
sensor, can be connected to the 
weather vane or plugged directly 
into the HAT. We want to use all 
the sensors, so make sure it's 
plugged into the weather vane 
and then plug that directly into the 
weather station HAT in the middle 
of the three ports. 


05 - RAIN GAUGE 


The final sensor to plug in is the rain 
gauge, which allows you to measure 
rainfall with the weather station. 
Plug it into the last remaining port 
on the weather station board, as 
shown in the image. 


Rainwater is collected in the top 
of the sensor, so that the amount 
of rainfall can be measured 


7 The networking and power 
input are set up away from 
the Raspberry Pi 


I 
I 
I 
I 
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Only one cable is 
needed to power the 
Pi and connect it to the 
outside world 


struts, while the weather vane 
has a flat paddle on one end 


SET UP THE 
SOFTWARE! 


Now it’s built, 
it's time to get 
the software 


working. 
Follow the 
handy online 
guide here: 
magpi.cc/ 
1QZYjt8 
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Image from the Met Office 


Analysis chart 
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)RECAST 


THE WEATHER 


How exactly can the readings help figure out upcoming weather: 


ll of us at some point have 
seen a TV weather forecast, 
but what does it all 

mean? The BBC have an excellent 
video that helps to explain the 
terminology of weather forecasts, 
and how the forecasts are made in 
the first place, which you can see 
here: youtu.be/IITCF3UPVu4. 

As you can see from the video, 
the weather forecast is determined 
by high pressure, low pressure, 
isobars, and fronts. High pressure 
is generally associated with good 
weather, which is defined as the 
air getting heavier and denser, 
creating higher air pressure. The 
air dries under high pressure; this 
usually occurs in the summer. 

Low pressure is the opposite: the 
air rises and draws in water vapour 
which then creates clouds. Clouds 
mean rain, eventually, and clouds 
also block the sun, meaning its 
heating effect is slightly negated. 
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Pressure maps for the weather 
are usually also represented with 
lines; these are the isobars and they 
determine the wind strength. If 
isobars are close together, it means 
strong winds; the further apart they 
are, the gentler the breeze is. 
Finally, fronts are the invisible 
lines that determine when two 
different masses of air meet 
together. The air can have different 
densities on each side, and be 
cooler or warmer. Fronts usually 
result in rain or storms, depending 
on their intensity. 


How to make 
predictions 
A weather forecast is a useful 
prediction of future conditions, 
but how are these predictions 
made? There are two key steps 
to predicting the weather. 

First is data collection. Vast 
quantities of data are collected 


about current conditions all over 
the world. This is done using 
satellites, ground-based observers, 
and weather stations like the kit 
you’re using. They gather data on 
temperature, pressure, wind speed, 
cloud movement, and other little 
bits of information. 

Once data is collected, it’s then 
modelled. This computer model, 
which knows the state of the 
weather at various points, then 
predicts the path of weather fronts 
and systems. These models are 
not always completely accurate, 
especially when you’ ve decided to 
have a picnic or go to the beach. 
The further ahead in time the 
prediction is, the less reliable it 
becomes. However, prediction 
models are becoming ever more 
sophisticated and, with the help 
of your experiments using the 
weather station, may become 
more accurate still. 


high pressure, 


L on this map 
stands for low 


is lower than its 


These are the 


(triangles), warm 
(semicircles), or 


in the weather 


H here stands for 


with the actual air 
pressure in millibars 


pressure, and you 
can see that the air 
pressure in millibars 


high counterparts 


occluded (mixed), 
and bring changes 


isobars, which show 
how the pressure 
changes in the air 


The fronts are cold 


June 2016 MdgPi 


75 


feature 


ORACLE WEATHER STATION 


4 7 
| 
: y, / 
Pa. 
4 f¢ 
f A 
ia 
y, a 4 


PA ar 


MEASURING 
WIND SPEED 


Get started using the weather station by finding out the current wind speed 


et’s use the anemometer, 
or wind speed sensor, to 
collect data about wind 
speed. The sensor has three arms 
with buckets on the end which 
‘catch’ the wind, causing the arms 
to spin. If you were to dismantle 
the sensor, you would find a small 
magnet attached to the underside. 
At two points within the 
magnet’s rotation, it triggers a 
reed switch which produces a LOW 
signal we can detect. So, for each 
full rotation of the arms, the sensor 
will produce two detectable signals. 


Detecting the signal 
Before we begin calculating 
wind speed, we need to be able 
to count the signals coming 
from the anemometer. Set up 
your Raspberry Pi and ensure 
you are in desktop mode, then 
launch a terminal window. 

Create a weather station 
directory by typing mkdir 
weather_station and 
pressing ENTER. Once that’s 
done, open up Python by 
typing sudo idle3, and add 
the following code... 
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#!/usr/bin/python3 
import RP1.GPIO as GPIO 


pin = 5 

count = @ 

def spin(channel): 
global count 
count = count + 1 
print (count) 


GPIO.setmode(GPIO.BCM) 
GPIO.setup(pin, GPIO.IN, GPIO.PUD_UP) 
GPIO.add_ event_detect( 

pin, GPIO.FALLING, callback=spin) 


input("Press enter to stop logging\n") 
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Now you can test your code! 
Press F5 and save when prompted. 
Your code should display the 
number of half-rotations counted. 
Press CTRL#C to stop the program. 

We can now count the signals 
from the anemometer; next, we 
need to calculate the wind speed. 


Calculating wind speed 
We can count the number of 
rotations of the sensor by doubling 
the detected inputs. But how do we 
change that into a speed figure? 
Let’s start by considering the 
formula for calculating speed: 


Speed = Distance / Time 


Imagine we counted the number 
of signals over the course of 5 
seconds. We now have the time, 
but we also need distance. The 
distance travelled by a cup will be 
equal to the number of revolutions 
multiplied by the distance 
around the edge of the circle 
(circumference). So we could write: 


Speed = Revolutions 
Circumference / Time 


The circumference can be 
calculated if we know either the 
radius or diameter of the circle. 
We can measure the radius of the 
circle made by the anemometer 
by measuring the distance from 
the centre to the edge. Knowing 
the radius, we can find the 
circumference with 2 x m xr. We 
also know that the revolutions 
are half the number of signals 
detected, so our formula becomes: 


Speed = (Signals/2) x (2 x m x r) 
/ Time 


This formula should enable us to 
calulate the speed of the wind in 
cm/s (centimetres per second). 


Updating the code 

Now that we’re able to calculate 
the wind speed from the 
information we can collect, 
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we need to add the code to make 
this work. We need to measure the 
radius (in cm) of the anemometer 
for use in the program, and 
decide on the time interval for 
calculating average wind speed 
(at least 5 seconds). 

Add to the code using the 
listing (on the right) as a guide 
— or download it — and save it 
as windspeed. py. 


Measurement units 
Currently, the program we have 
created will measure the wind 
speed in cm per second. However, 
this isn’t particularly useful. A 
more practical unit would be km 
per hour. In order to convert our 
units, we’ll need to convert cm to 
km and convert the seconds into 
hours. Work out how many cms are 
in a km, and seconds in an hour, 
and change the code accordingly. 


Calibration 
The program should now display 
the wind speed in km/h, but 
is it accurate? The info for the 
anemometer says that if it rotates 
once a second, that should equate 
to 2.4 km/h. So, in the example 
interval of 5 seconds, 5 spins (10 
signals) should equal 2.4 km/h. 
Run your program and spin the 
anemometer 5 times within the 
first 5 seconds. What wind speed 
value is reported? You should see 
something like: 


Ww CON HU BPWDN FE 


10 
2.03575203953 kph 


That’s not quite right! This loss 
of accuracy is due to something 
called the anemometer factor, 
and is aresult of some of the wind 


feature 


windaspeed.py (oie 


>PYTHON 


#! /usr/bin/python3 


import RPi.GPIO as GPIO DOWNLOAD: 

import time, math magpi.cc/ 
1WuoKwK 

pin = 5 

count = @ 


def calculate speed(r_cm, time sec): 
global count 
GIfG CEM = (2-" Maen-p1)) * Ff leM 
rot = count / 2.0 
dist_km = (circ_cm * rot) / 100000. 
# convert to kilometres 
km_per_sec = dist_km / time_sec 
km_per_hour = km_per_sec * 3600 
# convert to distance per hour 
return km_per_hour 


def spin(channel): 
global count 
count += 1 
print (count) 


GPIO.setmode(GPIO.BCM) 

GPIO.setup(pin, GPIO.IN, GPIO.PUD UP) 
GPIO.add_event_detect(pin, GPIO.FALLING, 
callback=spin) 


interval = 5 


while True: 
count = @ 
time.sleep(interval) 
print (calculate speed(9.@, interval), “kph") 


| : 
——— 


Above The 
anemometer, 
or wind speed 
sensor, is avery 
simple device 


energy being lost in turning the . 
arms. To compensate for this, we 

are going to have to multiply the 
reading generated by our program 

by a factor of 1.18, which should 
correct this error. Update the final = 
line in the calculate_speed 

function to read: 


return km_per_hour * 1.18 


Rerun the code and this time you 
should get a value closer to 2.4. 
If you’re having a bit of trouble 
getting the code right, download 
the complete version of it from 
here: magpi.cc/1WuolIVF. 
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FREQUENTLY 
ASKED QUESTIONS 


Your technical hardware and software problems solved... 


YOUR QUESTIONS ANSWERED 


PI ZERO 1.3 
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New cable 

The standard cable that comes with the Camera 
Module is too big for the connector on the Zero (the 
normal one couldn’t fit), so you’1l need to replace it 
with a different one. They’re available online from 
places like the Pi Hut: magpi.cc/1V5N9dh. 


Insert the cables 

The connectors on both the camera board and the Pi 
Zero open by pulling back a tab that secures the cable. 
Make sure the silver strip on the new ribbon is the 
Same orientation as the old one on the board, secure 
it, and then connect it in the same way to the Pi Zero. 


Enable the camera 

Once the camera is connected up, turn on the Pi Zero. 
After it loads up the desktop, go to the Program menu 
and select Preferences>Raspberry Pi Configuration. In 
the Interfaces tab, you’ ll find an option to enable the 
Camera Module. Do this and then reboot. 


NEEDA 
PROBLEM 
SOLVED? 


Email magpi@raspberrypi.org or 
find us on raspberrypi.org/forums 
to feature in a future issue. 


ca 


Check the power 

Make sure you have enough power going to the Pi Zero, 
either by using an official Raspberry Pi power supply or 
checking the amps on your adaptor. If you have too much 
plugged in, it may not run well off a PC’s USB port. 


Manual SD card creation 

If NOOBS isn’t working, then you’ll need to burn the 
SD card manually. Download the image for the latest 
Raspbian to your computer and then follow the guide 
to writing an SD card: magpi.cc/1V50j8E. 


New SD card 

Your SD card might be shot from too much use, so it 
may be worth getting a new one and then following 
the guide to write the image manually to the SD card. 
8GB cards are generally best for the Pi Zero, although 
you can use slightly larger cards. 


Taking photos 

The Pi camera on the Zero will work the same way it 
does on anormal Raspberry Pi. Once the camera is 
enabled, you can use raspistill in the terminal to 
Start taking photos from the camera. You can read a full 
cuide to how it works here: magpi.cc/1YuuU03. 


Taking video 

Again, the raspivid command in the terminal will 
work in the same way. The Pi Zero being so slimline 
means you can make a great little camera for quick 
videos or a Go Pro-style experience. Read more about 
it here: magpi.cc/1V5ODEy. 


Programming with Python 

With the correct libraries, you can program the 
camera with Python, which you can do slightly 
more easily through the terminal. We have a pretty 
thorough guide to doing different things with the 
camera in Python in issue 45 of The MagPi. 
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Does the Raspberry Pi support networking? Does the Raspberry Pi have built-in wireless networking? 


The Model B, Model B+, and Model 2B/3B versions Only the Pi 3 has built in wireless LAN, but all other models 
of the device have built in 10/100 wired Ethernet. can support a USB WiFi dongle. The Foundation offers its own 
There is no Ethernet on the Model A, Model A+, branded WiFi dongle which has been fully tested for use with 
and Zero versions. the Raspberry Pi. It is available through the Swag store. You 


can, of course, use a dongle from another provider if you wish. 
Does the Raspberry Pi support any form 


of netbooting or PXE? Why is there no Gigabit Ethernet? 
The Raspberry Pi does not support PXE booting or The Ethernet is attached via the USB 2.0 bus, so the 
network booting without an SD card. If you want to upstream bandwidth would not support Gigabit. 


network-boot multiple Raspberry Pis, you could use 

PiNet. This is a free and open-source community-based Does the Raspberry Pi have built-in Bluetooth? 
project initially designed for schools. Each Pi boots off a Only on the Raspberry Pi 3. 

small set of startup files on an SD card and fetches the 


rest of the data it needs from the PiNet server, thereby How do I connect more USB devices? 

allowing you to maintain a single operating system image | Use a USB hub to increase the number of ports. Some 

for all the Pis. PiNet also adds network user accounts, keyboards have USB hubs built in, which would work well. 
shared folders, and automated backups. It is highly recommended that you use a powered USB hub. 


Having trouble with The MagPi on the App Store or Google Play? 


Here are your most common questions answered: 
peanER 


How do | find The MagPi on Google Play 

or the App Store? 

All you have to do is go to the search bar and type ‘The MagPi 
or ‘Raspberry Pi' to find us. 


I've subscribed to the digital edition and | can't sign 

in to restore my purchases. Please help! 

Since your The MagPi purchases are linked to your Google or Apple 
accounts, there's no need to sign in at all. If you'd like to re-download 


your purchases on your current device, or make your purchases 
available on other devices, all you need to do is press ‘Subscribe’ 
on the home screen, then ‘Restore Purchases’ on the next screen. 


GET IT ON 


>» Google Play 


How can | search the digital magazine for keywords? 
Finding direct references is really easy with The MagPi app: all you 
have to do is tap the screen to get the app's GUI to show, and then 4 Available on the 


press the small magnifying glass icon in the top-right corner of the & A p p Sto re 
screen. Just type in your search term to find the relevant results. 
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community- 
developed, 


Ubuntu-based 


operating 
system that 
beautifully 
integrates 
the MATE 


desktop 
Ubuntu 


[=] introduction 


ubuntu MATE "64 


Choose an option to discover your new operating system. 


tr Features 


= Commurety 


a, Chat Room 


<p> Get involved 


= Shoo 


UBUNIU MAI 


Ubuntu 16.04 LTS runs really well on the Raspberry Pi 
using the lightweight MATE desktop environment 


RASPBIAN 
Raspbian is 
the officially 
supported 
operating 
system of the 
Raspberry 

Pi, and is the 
best all-round 
operating 
system for 
learning and 
general use. 


Pistia = 


Free 
raspbian.org 
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ith its 1.2GHz processor, 
plus WiFi and Bluetooth, 
the Raspberry Pi 3 has 
the chops to match some laptops. 
This speed boost has thrown 

new light on alternatives to 
Raspbian, the officially supported 
operating system. 

On Intel-based desktops, Ubuntu 
is one of the biggest names in 
Linux. Canonical, the maker of 
Ubuntu, has just released version 
16.04 LTS of the Ubuntu operating 
system. Surely this would be a 
splendid time to get Ubuntu on the 
Raspberry Pi? 

This is where Ubuntu MATE 
steps in. Ubuntu MATE isn’t quite 
the full edition of Ubuntu: it swaps 
out the Unity desktop interface for 
a lighter version known as ‘MATE’. 

Ubuntu MATE for the Raspberry 
Pi was developed by Martin 
Wimpress and Rohith Madhavan, 
and it intersects nicely with the 
recently released Raspberry Pi 3. 
Ubuntu MATE is built on the 
brand new 16.04 LTS edition, but 


with an older and less demanding 
interface. Sounds perfect, right 
We found the installation to 
be a relative breeze, although a 
16GB microSD card was required 
(the instructions hint that you 
might want to use one). When you 
start up Ubuntu MATE, a welcome 
screen offers specific Raspberry Pi 
information. Here you can resize 
the file system to use the full space 
on the SD card (rather than the 
default 3.9GB image size). 


A familiar MATE 

MATE is a slicker interface than 
LXDE (the desktop included with 
Raspbian). While the two are 
functionally similar in many ways, 
MATE has rounded windows and 
more colourful buttons. It’s also 
vastly more customisable, witha 
range of preferences to change how 
it looks and works. A MATE Tweak 
setting enables you to determine 
the appearance and included 
elements for the desktop, interface, 
and windows. 


Ubuntu MATE comes packaged 
with a comprehensive set of 
default programs. Caja is the 
default file management app, 
which is on a par with PCMan, 
although not as feature-rich 
as Nautilus (included with the 
desktop version of Ubuntu). 
Pluma is the default text editor; 
again, we find this slightly 
more stylish than LeafPad, 
although both are basic as 
regards functionality. 

Beyond this, you get the 
LibreOffice suite and Firefox 
web browser. Programming is 
covered with Scratch, IDLE, and 
Sonic Pi. One area where it excels 
is multimedia, with big-name 
apps like Rhythmbox, VLC media 
player, and Shotwell working out 
of the box. 

Although you get access to the 
Ubuntu repository in Ubuntu 
MATE, you don’t get access to the 
Raspbian repository by default 
(and so we needed to add it from 
magpi.cc/24IM2D8). 
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It’s a good idea to manage your 
expectations on software. You 
still only get access to AArch32 
(ARMv7) software, not Intel 
i86 packages. Programs like 
VirtualBox, Minecraft Java, and 
Adobe Flash remain out of reach. 

While Ubuntu has a lot of 
consumer software, Raspbian has 
better programming tools in the 
box: Blue J Java, Node-RED, and 
a free version of Mathematica 
(software that costs £190 on other 
Linux operating systems). 


An educational OS 
Raspbian remains a much better 
choice for learning the nuts and 
bolts of programming, thanks to 
its wider range of coding programs. 
This is also because Raspbian 
features in so many tutorials, while 
Ubuntu MATE leaves you to figure 
things out. 

It’s not a complete loss. Ubuntu 
MATE comes with RPI.GPIO and 
epiozero installed, and we found it 
just as easy to get an LED blinking 
in Ubuntu as Raspbian. 

Even so, with most tutorials 
aimed at Raspbian users, you’d be 
better off sticking with the official 
distro for education and learning. 

We put both Raspbian and 
Ubuntu MATE through a series of 
speed tests to determine which has 
the edge for performance. 
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Our first test was a stopwatch 
for startup (from the time the 
power was connected to the point 
you can click and get a response 
from the menu). We disabled 
the welcome screen on Ubuntu 
MATE and turned on automatic 
login. Ubuntu MATE started up 
in 39.59 seconds while Raspbian 
was ready in 20.91 (almost twice 
as fast). 

The slower performance 
extended to opening apps. 
LibreOffice took 9.18 seconds 
to start in Raspbian, and 16.25 
seconds in MATE. 

We installed HardInfo on both 
operating systems and ran a series 
of system benchmarks with the 
winners in bold: 


> CPU BLOWFISH (HIGHER BETTER) 
43.70 - Raspbian 
40.87 - Ubuntu MATE 

> CPU CRYPTOHASH (HIGHER BETTER) 
24.63 - Raspbian 
24.94 - Ubuntu MATE 

> CPU FIBONACCI (LOWER BETTER) 
13.47 - Raspbian 
14.03 - Ubuntu MATE 

> FPU FFT (HIGHER BETTER) 
48.73 - Raspbian 
47.95 - Ubuntu MATE 

> FPU RAYTRACING (LOWER BETTER) 
43.89 - Raspbian 
54.25 - Ubuntu MATE 


U 
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This Machine 


PowerPC 740/750 (280.00MHz) 
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Left Firefox is the web browser of choice for Ubuntu MATE 
Above Get great system monitoring tools through the OS 
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Raspbian was faster in every test 
apart from CPU CryptoHash, where 
having a higher score is better (and 
the 0.3-second difference seems 
negligible to us). 

Having said that, Ubuntu 
MATE is perfectly usable on the 
Raspberry Pi, and we had no 
problem running multiple apps 
and programs. If your focus is to 
run a Raspberry Pi as a regular 
computer, then Ubuntu MATE has 
a lot to offer over Raspbian. 


fast word 


While Raspbian remains 

a better choice for project 
building and education, we 
have oodles of admiration 


for this fully rounded 
desktop operating system 
running on the Raspberry 
Pi 3 microcomputer. 


Above The 
presentation is 
very much likea 
standard Linux/ 
Ubuntu release 
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Waker 
days 


Makes It 


easy to move 


your messy 
Raspberry Pi 
breadboard 
projects to 

aq PCB 


ProtoBoards.co.uk 


PROTOPAL 


Possibly a better 
choice for larger 
Pi models, 

it features a 
larger 288-hole 
prototyping area 
and two (user- 
connected) 
power rails 


il 


© 25/987 
magpi.cc/1TzsZ69 
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PROTOZERO 


An easy-to-use prototyping board with perfect Pi Zero proportions 


readboards are great for 

testing out electronics 

projects, but the end 
result may well look messy, often 
featuring a spaghetti-like tangle 
of jumper wires. Not only that, but 
such a setup isn’t all that portable, 
as some loose wires or resistors 
could easily fall out if you dare to 
move it. If you’re looking to make 
your project more permanent and 
practical, you’1l want to solder the 
components to a prototyping board 
like this one. 

The subject of a successful 
KickStarter campaign, the ProtoZero 
is the brainchild or Richard 
Saville, author of the popular 
averagemanvsraspberrypi.com 
blog. Resembling the little brother 
of his previous ProtoPal prototyping 
board, it’s made of perfboard and is 


=%», designed to match the dimensions 
?_of the Pi Zero perfectly, although it 


can also be used on any other 40-pin 
model, including the Pi 3, 2, A+, and 
B+. While it is can not technically 

be described as a HAT, as it lacks 


an EEPROM, the ProtoZero does sit 
neatly on top of the Pi’s GPIO pins, 
for which it has two corresponding 
rows of connector holes with helpful 
labels. The remaining 154 holes — 
likewise featuring high-quality ENIG 
(electroless nickel immersion gold) 
PCB plating — are arranged in printed 
lanes of three or four. Components 
may be soldered to the front or 
(similarly labelled) rear, if you want 
to hide unsightly wires and suchlike. 
Example project ideas include an 
LED array, temperature monitor, and 
four-character digital display, but 
the only limit is your imagination. 
Note that since the ProtoZero 
comes in kit form, you’ll first need 
to solder the supplied 40-pin GPIO 
header to the board, but this is no 
more difficult than doing so for 
the Pi Zero itself - and you’ ll be 
soldering components to it anyhow. 
One advantage, as well as reduced 
cost, is that you may elect to use 
a stacking header (not supplied) 
instead, enabling you to stack 
multiple ProtoZeros and/or HATs. 


While some veteran electronics 
project makers may prefer 
to create their own custom- 
made prototyping boards from 
inexpensive perfboard, the 
ProtoZero is ideal for less- 
experienced users who want to take 
their projects one step up from 
the breadboard. With its perfectly 
rounded edges and matching form 
factor, it also gives a professional 
look to Pi Zero projects. 


fast word 


The ProtoZero offers 
electronics dabblers an easy, 
inexpensive way to make their 
projects more permanent, 
while neatly matching the 
dimensions of the Pi Zero for 


a polished finish. Using high- 
quality PCB plating, it features 
a labelled breakout of the 40 
GPIO pins, along with a decent- 
size prototyping area. 
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£20 /$29 


PICON 
ZERO 


Amuch more 
compact version 
of the RoboHAT, 
designed for 
the Pi Zero, 
although it can 
also be used 

on a standard 
Raspberry Pi. 


£13 / $19 
magpi.cc/Ip9wGaA 
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Waker 
days 


Complete 
robotics 
controller for 
Raspberry Pi 


Atronix 


ROBOHAT 


A full-sized Raspberry Pi robotics controller and the bigger sibling 
of the Picon Zero. Should this be your controller of choice? 


nother month, another 
robot board for your 
Raspberry Pi; this time 
we’re looking at the RoboHAT from 
4tronix, basically a bigger version 
of the Picon Zero we looked at last 
issue. This board is designed to 
work with all 40-pin Raspberry Pis 
(so no original Model A or B, sadly) 
and as it’s a HAT, it attaches neatly 
on top of a compatible Raspberry Pi 
without hanging off the sides. 

Like the Picon Zero, the 
RoboHAT comes with an amazing 
number of inputs, outputs, and 
general robot connections to 
make use of. It all comes pre- 
soldered on a very sturdy piece 
of PCB, so you’re ready to start 
using it right away. On the board 
are the requisite DC motor screw 
terminals; the RObDOHAT comes 
with two, enabling it to control two 
motors. There’s a set of pins for 


connecting the popular HC-SRo4 
ultrasonic distance sensor, anda 
mixture of ten input and output 
pins, along with a series of I?C 
breakout pins. It’s powered by a DC 
jack that can also handily power 
the Raspberry Pi while in use, 
cutting down on power inputs. 

It’s all more spread out than 
on the Picon Zero, so the board 
becomes a bit less of amess when 
everything is connected up and in 
use. There are also custom Python 
scripts and libraries to get it all 
working, making programming 
very easy. For example, importing 
the robohat module allows for 
robohat.forward() to move the 
robot forward. There are many 
examples included to get your head 
around how the library works, and 
they’re all very easily installed 
using the instructions on the 
4tronix blog: magpi.cc/1TPBtWJ. 


It’s a good board for novices and 
also some advanced users, allowing 
you to take the skills you may have 
learnt from a very simple kit and 
apply them to a custom project of 
your own design quite easily. It’s 
easy to find out which GPIO pin 
controls which aspect, so you can 
create further custom code if that’s 
your thing, making it fairly open 
and versatile. It’s also a pretty 
good price at only £20. 


fast word 


Awell-designed robot HAT 
that works very well with 
the Raspberry Pi and many 


common robotics components. 
Definitely worth a look if you're 
planning to advance your 
Raspberry Pi robotics. 
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Turn your 


Raspberry 
Pi into a 
modern 
indoor air 
quality 
monitoring 


device 
LiV Pi 


magpi.cc/1Va4d23 


B4 


RASPBERRY 
P| ORACLE 
WEATHER 
STATION 


It's not quite the 
same, but you 
can measure 

the weather with 
the Raspberry Pi 
Oracle Weather 
Station, albeit 
without precise 
pollution sensors. 


3 
cI 
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A powerful air quality monitor made for the modern and slightly 
polluted world, powered by Raspberry Pi 


oming from Hong Kong, 

the LiV Pi is a curious, 

Raspberry Pi-compatible 
product. Marketed somewhat as 
a device for businesses to keep an 
eye on the air quality inside their 
buildings, it’s a product that’s 
been created mainly to suit the 
situation in Hong Kong. The city 
has some serious air pollution 
problems, which you can read more 
about elsewhere. So, with that and 
general building safety in mind, it 
does start to make more sense. 

What the LiV Pi boils down to 

is a large, colourful acrylic case 
with a two-line LCD display on the 
front. Inside, you’re supposed to 
install a Raspberry Pi along with 
the specially provided add-on 
board that functions almost like a 


HAT. This HAT allows you to plug 
in some supplied sensors and a 
real-time clock, and then you’re 
basically ready to go. 

LiV Pi ships with three main 
sensors: a carbon dioxide (CO,) 
sensor, a temperature/humidity 
sensor, and an air pressure 
sensor. The CO, sensor is the main 
component here, and the LIV Pi 
team explain on their website that 
a rise in CO, levels in the air isa 
good indication of air quality, since 
it’s likely to have bought much 
nastier air with it. The humidity 
and temperature sensor allows you 
to keep track of the environment 
indoors in other ways, and it 
sounds like the barometric 
pressure sensor was thrown into 


the system just because they could. 


There’s some fun to be had 
constructing the full LiV Pi. On the 
website, you can buy a bare-bones 
kit of the sensors and board (pre- 
soldered or not). Alternatively, 
you can get the full version with a 
case, which is what we’re looking 
at here. The price does seem quite 
steep; $350 for the full LiV Pi is 
not an easy number to swallow, 
although it’s not ‘targeted’ 
towards consumers per Se. 

The construction is quite simple. 
With the full kit you get the acrylic 
case, which almost snaps together 
and is made up of six pieces. The 
Snapping isn’t very firm, so there 
are screws and spacers to Keep it 
together, making it fairly easy to 
assemble and disassemble when 
needed. This version also comes 
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with everything already soldered up 
on the boards. Then again, there’s 
not a huge amount of soldering to 
be done with the basic kit version 
(from S35): the odd resistor and 
connector is all that’s required, 
with the trickiest bit being the 
40-pin connector for the GPIO. 
Once the case is together, it’s just 
a matter of plugging the sensors into 
the correct ports, putting a battery in 
the RTC, and hooking it up to the LCD 
screen. The guides online and the 
markings on the boards show more 
than enough to do this accurately. 
Finally, you'll need to install an SD 
card with the custom LiV Pi image 
before packing it all in the case. 
With the full pre-soldered kit this 
is all quite quick; in fact, writing 
the SD card will take longer than 
constructing the rest, so you should 
probably get that started beforehand. 
The software requires a bit 
of setup to get working at full 
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capacity. You need to make sure 
it has anetwork connection and 


that the hardware clock is working, 


and you can also set up email and 
other message alerts. This does 
allow you to keep the LiV Pi in its 
box most of the time, though; you 
can dial in with a browser to view 
data and get email updates about 
the current readings instead of 
manually plugging it back into 

a monitor. The whole system is 
pretty complete and is continually 
eetting updates; at the time of 
writing, they had recently added 
Raspberry Pi 3 support and have 
even begun selling the full kit with 
a Pi 3. So, for the moment, it’s well 
Supported and with upgrades to 
come in the future. 

However good it is, with decent 
sensors and good software to keep 
an eye on them, we do wonder how 
useful a device this will be. We 
can definitely report that it does 


what it sets out to do: it monitors 
the air, and it does it well. If this 

is something you or a business 
have been looking for, then it’s 
definitely worth a look due to its 
extra network connectivity and 
customisation over other solutions. 


a 


There's plenty 
of space inside the 
case for the Pi, and 
there are some 
easy-access points 
for specific ports 
as well 


—=—s—Cs—f 


The 
full range of 
components is not 
very high when 
it comes in a full 
kit, and they're all 
quick to assemble 


It has very limited uses and is quite expensive, but 
the design is good and it does what it sets out to 
do very well. Building it is pretty fun, too. 


KKKK 


June 2016 MagPi | 85 


RASPBERRY PI 
BESTSELLERS 


A new generation of C tutorials for 
aq new generation of programmers 


LEARN C 
THE HARD 
WAY 


Author: Zed Shaw 
Publisher: Addison Wesley 
Price: £24.99 

ISBN: 978-0321884923 
magpi.cc/1TQkpD1 


Zed Shaw's famous ‘type all 
of this in yourself’ method of 
instilling learning, brought to 
C. Strongly opinionated but, if 
you get on with it, a practical 
introduction to C basics. 


LEARN TO 
PROGRAM 
WITH C 


Authors: Noel Kalicharan 
Publisher: Apress 

Price: £17.50 

ISBN: 978-1484213728 
magpi.cc/1TQkjJBu 


Acomprehensive C tutorial for 
non-programmers that - despite 
missing appendices on setting 


up a compiler - wins friends 


through the excellent clarity of 


the author's explanations. 


PROGRAMMING IN C, 
4TH EDITION 


Authors: Stephen G Kochan 
Publisher: Addison Wesley 
Price: £30.99 

ISBN: 978-0321776419 
magpi.cc/1TQkIxs 


Comprehensive, a classic (now 
on its fourth edition), and very 
detailed: serious but readable. 


If you struggle with pointers, 


this could be the book to give 


you that ‘aha’ moment. 
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PROGRAM 
ARCADE GAMES, 
WITH PYTHON 

AND PYGAME 


Author: Dr Paul Vincent Craven 
Publisher: Apress 

Price: £29.99 

ISBN: 978-1484217894 
magpi.cc/1Wo2yNA 


Based on 
Craven’s popular 
programarcadegames.com 
website, and now in its fourth 
edition, this book does a superb job 
of fitting programming concepts - 
and Python learning — to building 
several games with the ever useful 
Pygame library. Programming 
lessons are carefully introduced 
throughout each game or game- 
related project — starting with 

type correctness in the opening 
calculator example. 

Aimed at younger readers, but 
accessible to all, Craven’s teaching 
experience shows through in 
both tone and pace: this is a book 
that you will not finish quickly, 


EXPLORING THE 
RASPBERRY PI 2 
WITH C++ 


Author: Warren Gay 
Publisher: Apress 
Price: £29.99 

ISBN: 978-1484217382 
magpi.cc/1TQkeaS 


C++ is a powerful 
and complex beast, which does 
little to protect you from your 
mistakes, and is not something 
we often see in a Pi project. 
Nevertheless, if you’ve learnt the 
basics, you can build your skills 
while experimenting with your 
favourite single-board computer, 
thanks to this interesting tour 
of the Pi, its hardware, and some 
useful C++ programs. 

Download the code from 
magpi.cc/1TQkoyY and you’ll 
get useful utilities like gp, which 
manipulates and reads the GPIO 


but should keep you motivated 
through the journey. Along the 


way, everything from functions 


and lists, through searching 
and sorting, to sprites 
and array-backed 
erids will be gradually 
absorbed, until the reader 
has the skills to write their 
own games. 

There is plenty of code 
in this book — more than 
we’d normally expect 

to see — but Apress’s 
production is excellent here, with 
pages looking well balanced, and 
beginners unlikely to be unnerved 
by the sight of so much Python! 
Plentiful exercises, including a 
whole chapter at the end revisiting 
every project in the book, drive 
the lessons deep. Well written, 
well developed, and — despite 
eschewing the self-conscious 
whimsy of some other tutorials - 
very enjoyable to work through. 


Score 


interface, and pipwm, for handling 
PWM (pulse-width modulation) 
signals. The powerful pispy 
captures GPIO data and in 
the book is used to build an 
oscilloscope. Practical electronics 
feature in circuit designs for 
debouncing input signals. 

A C++ primer feels slightly 
misplaced three quarters of the 
way in, but you can skip forward 
to that point at any time. Lastly, 

a multicore web server highlights 
the Pi 2’s abilities, then leaves 

the challenge of improving and 
finishing the project to the reader. 
Appendices on GPIO classes, and 
other classes — such as Matrix, 
which document those used earlier 
in the book - round off a book 
which may be essential, if you 
want to work on your Pi with C++. 


Score 
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LEARNING PYTHON 


Author: Chetan Giridhar 
Publisher: Packt 

Price: £25.99 

ISBN: 978-1785888038 
magpi.cc/1TQkVRj 


Learning Python 3 
~8Sign Patterns 
Second Ealitian 


When Kent Beck and 

Ward Cunningham 

began applying the concept of 

design patterns, espoused by 

architect Christopher Alexander, 

to programming, OOP (object- 

oriented programming) was still a 

relatively tiny niche. As it grew over 

the next decade, design pattern 

use Spread, and basic patterns 

were collected in the famous 

Gang of Four book. These proven 

development paradigms speed up 

programming, and well-defined 

components and interfaces make 

for scalable and maintainable code. 
With many of today’s 

intermediate Python programmers 

not coming from a formal Java 

or C++ background — and many 


INTRODUCING GO: 
BUILD RELIABLE, 
SCALABLE PROGRAMS 


Chetan Olrititar 


Author: Caleb Doxsey 
Publisher: O'Reilly 
Price: £16.50 

ISBN: 978-1491941959 
magpi.cc/1TQkZkg 


PUR Li iy tage 7 

TOMAS Pare a, 
a 
=— 


Go may bea 
difficult word to 
Google for, but 
the language has many positives — 
bringing 40 years of advances to a 
C-style language, from concurrency 
to memory safety. The key feature 

is simplicity, even at the cost of 
missing out on features taken for 
eranted in other languages. 

To match the Go language’s 
simplicity, this is a concise, efficient 
introduction to a concise and 
efficient language, and very much 
in the tradition of K&R. Indeed, 
you’ ll find yourself taking that 
classic off your shelf to check half- 
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Introducing 


- ie Ua 


patterns being workaraounds 
for the limitations of those two 
languages — what’s needed 
is an introduction from 
the perspective of dynamic 
scripting languages like 
Python. Giridhar provides 
this with a practical, 
Python-based look at several 
well-known patterns, from 
Observer to MVC patterns. 
Following a useful 
introduction to OOP concepts and 
design patterns, we start with the 
Singleton design pattern, then 
progress through several patterns — 
all with Python code, and practical 
examples, as well as a discussion 
weighing up the advantages and 
disadvantages. Lastly, AntiPatterns 
tells the reader “what we shouldn’t 
do as architects or software 
engineers.” Concise, thoughtful, 
and a useful stepping stone on your 
Python journey. 


Score 


remembered references as you spot 
them in Doxsey’s Go introduction. 
Types, variables, and control 
structures make for a gentle start, 
with the opening chapters 
accessible for relatively 
inexperienced programmers. 
Exercises at the end of each 
chapter ensure that the 
reader thinks through each 
topic covered. 
‘Arrays, Slices, and Maps’ 
— we were very pleased to 
see an Oxford comma in the 
chapter title - and ‘Functions’ 
manage to cram a lot of idiomatic 
Go into explanations which, like the 
language, know what to leave out. 
Concentration is required for the 
pared-back coverage of further Go 
features, then chapters on packages, 
testing, and concurrency leave the 
reader well prepared to tackle some 
real-world challenges in Go. 


Score 


ESSENTIAL READING: 


DJANGO 


The Django web framework is the comprehensive, 
and Pythonic, answer to your website needs 


Django Girls Tutorial 


Author: Django Girls 
Publisher: Online tutorial 
Price: Free 

ISBN: N/A 
magpi.cc/1W/ptxT1 


From total beginner to fully working | 
blog site with Django - an online version 
of the Django Girls workshop. 


Beginning Django CMS 
Author: Nigel George 

Publisher: Apress 

Price: £22.99 

ISBN: 978-1484216705 
magpi.cc/1WptBlT 


George assumes no Django 
knowledge, and gets you up and 
running - a welcome alternative to 
the occasionally opaque official docs. 


Django By Example 


Author: Antonio Mele 
Publisher: Packt 
Price: £28.99 

ISBN: 978-1784391911 
magpi.cc/1WptlOn 
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Django By Example 


Useful collection of real-world websites, 
from social sites to online shops. Good 
integration of other technologies. 


Two Scoops of Django 
Author: Daniel Roy Greenfeld 


& Audrey Roy Greenfeld 
Publisher: Two Scoops Press SCOORS OF 
DJANGO 
Price: £31.12 


ISBN: 978-0981467344 BEST PRACTILES 


magpi.cc/1WptMho 


High-level, low-level, practical, 
philosophical, opinionated, essential - 
a reference that makes “Python and 
Django as fun as ice cream.” 


High Performance Django 


Author: Peter Baumgartner 
& Yann Malet 

Publisher: CreateSpace 

Price: £28.23 

ISBN: 978-1508748120 

magpi.cc/1WptNl3 


“A repeatable blueprint for building and 


deploying fast, scalable Django sites” 
with lessons beyond Django sites. 
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THE MONTH IN 


Everything else that happened this month in the world of Raspberry Pi 
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Using several 

strips of LEDs and 

a gesture control 
HAT, Connor Ballard 
was able to create 
a light that moves 
with your fingers. It’s 
more complicated 
than it sounds! 


n early 2015, the Raspberry Pi Foundation set up a 

new programme called the Raspberry Pi Creative 

Technologists (rpct.io). Nine young creative 
people between the ages of 16 and 21 were put through a 
year-long programme of activities, to help them enhance 
their current creative projects through technology such 
as the Raspberry Pi. After a year of studying and making, 
it was finally time for the Creative Technologists to show 
off what they’d learnt at a special exhibition put on at 
Raspberry Pi HQ in Cambridge during April. With such 
projects as ‘Who is Terror’ (youtu.be/w3VA7nCgorl) and 
an interactive pop-up book, there were plenty of amazing 
things to see at the exhibition. If you weren’t able to make 
it, we’ve put together a little gallery for you to enjoy. 


The ‘blinkenlights’ project from Andrew Mulholland 
creates beautiful illuminated pictures with LEDs and overlays 


This interactive pop-up book by Maddy Pendergast almost 
stole the show, with the book projected onto paper to make the effect 
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S000 suiprep' 


The Raspberry Pi crowdfunded 
computer is currently making 
its first shipment to backers 


t’s been a busy 18 months for the pi-top crew. 

No sooner had they launched their long-awaited 

pi-top Raspberry Pi laptop than they began 
crowdfunding a new project: the pi-topCEED, a $99 
Raspberry Pi desktop computer. Coming as a kit with 
a screen and Pi-powered innards, it’s a stripped back 
version of the original pi-top that came out at the end 
of last year, allowing the price to be reduced to hit that 
attractive sub-S100 mark. 

Things have progressed fairly well with the project, with 
only a slight delay to the original delivery date of April. 
That’s pretty good for a crowdfunded project, and the 
delay was to accommodate an upgraded screen anyway. 
The pi-topCEEDs are now finally making their way to 
backers as 5,000 are shipped out around the world. 


We’ve been keeping an eye on what the pi-top team B E S | : O oo Ys : E RE S | : 
get up to for a while now, due to their inventive view of a 
highly customisable, upgradable Raspberry Pi computer 


that’s ideal for learning programming and physical 
computing. Hopefully, the backers are happy with the 


6 ee Se S SHUFFLER 
CEED UNIVERSE 


The educational game from the folks at CEED is a very 

retro-looking open-world puzzle game that requires 

you to do actual coding to survive. It can also interact Sagal ame 
with physical computing, so you can create and learn \ lo- ° Pra, “a's 
about circuits as you play. All of your progress is saved 
to the cloud, so you can continue wherever you have 
access to the game. It’s still in active development, 


| 


but it has come on in leaps and bounds since we first | p | STANT PI é A ) ) E RA 
coveted it in isstie 40 of the magazine. 


magpi.cc/1quGxXil 
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© PI AND MORE 9 


7 ISTE RASPBERRY PI JAM | 


RASPBERRY \— 


Want to add your get-together? List it here: 


raspberrypl.org/jam/add 


RASPBERRY JAM LEEDS P| AND MORE 9 RASPBERRY JAM HULL 


When: Wednesday 8 June When: Saturday 11 June When: Saturday 25 June 
Where: Swallow Hill Community Where: Universitat Trier, Trier, Where: Malet Lambert School, 
Collegerreccde sik Germany ell, (Wisc 
magpi.cc/10vi5¢gl magpi.cc/1TcyAp4 magpi.cc/1TcyH3X 
The aim of this Raspberry Jam At Pi and More, beginners At the Hull Jam, you’ll be able to 
event is to bring people together and experts meet for talks, get hands-on with digital making 
from across a wide area, to discover workshops, and projects activities, through workshops and 
the exciting potential of the Pi. focusing on the Raspberry Pi. a hackspace area to share projects. 
STAFFORD RASPBERRY JAM RASPBERRY JAM: 1ST WIMBLEDON 
When: Wednesday 8 June SLICE OF PI CLUB RASPBERRY JAM 
Where: King Edward VI High When: Tuesday 21 June When: Sunday 26 June 
School, Stafford, UK Where: Heart of Worcestershire Where: Wimbledon Library, 
magpi.cc/1TcysWv College Redditch Uk Wimbledon, UK 
A big meetup where Pi magpi.cc/1iTcyCo3 magpi.cc/1OviCP} 
enthusiasts get together, share Spring season of the Slice of Pi Club For people interested in making, 
ideas, help each other, and most where people show off projects, creating, programming, electronics, 


of all have fun! learn skills, and make robots. robots, and computing in education. 
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SLICE OF PI CLUB 


ISTE RASPBERRY PI JAM 
When: Monday 27 June 
Where: Colorado Convention Center, 
Denver, 
CO, USA 
magpi.cc/10OviJul 
This open session will allow people 
to learn all about the Pi from 
Raspberry Pi Certified Educators. 


RASPBERRY JAM PRESTON 
When: Monday 4 July 
Where: Media Factory Building, 

Pies von, WLC 
magpi.cc/10viZcF 
Jom the Preston Preommunnity as they 
learn, create, and share the potential 
of the Raspberry Pi computer at an 
open, family-friendly event. 
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RASPBERRY JAM 
PRESTON 
G RASPBERRY JAM HULL 
STAFFORD 
RASPBERRY JAM 
1ST WIMBLEDON 
RASPBERRY JAM 
~~ 
RASPBERRY JAM: [yr -; 


DOIN TT IMSS: 


When: Monday 27 June Where: Colorado Convention Center, Denver, CO, USA 


Held during the four-day 
ISTE technology conference, 
this will still act like a 
normal Jam, albeit in a 
much larger space. That 
means you can come and 
show off your project, and 
also watch demos and 
presentations on how to 
use the Raspberry Pi to 

its full potential. For more 
details, check out the event 
page: magpi.cc/10viJul 
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Witha 
slightly higher 
resolution and 
a NolR version, 

motion activation 
can be optimised 
further with the 
new camera 
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Subscription gift 

The new camera connector on the Raspberry Pi 
Zero is brill. It was actually something I’d been 
really wanting on there! I have a question, though: 
I don’t have a subscription, but I’ve been thinking 
of picking one up. I know you get a Raspberry Pi 
Zero with a subscription — has this been changed to 
one of the new Raspberry Pi Zeros with the camera 
connector? Will it also come with the cable adapter? 
It would probably persuade me to get one! 

James Daid 


As of this issue, any new subscriptions can get a 
bundle with a new Pi Zero with the camera port, 

the cable bundle we previously gave out to adapt 

the micro USB and mini HDMI ports, and the camera 
cable! The only downside is you won’t be getting 
issue 4O with it, although it’s still available as a 

free PDF download from our website. You can get 
this with 6- and 12-month subscriptions, and you 
can find out about them at magpi.cc/Subs1 


Camera compatibility 

There’s both a new camera and a new Raspberry Pi 
Zero out, so I was wondering what the compatibility 
between the two was: Does the original camera 
work with the Pi Zero? Is it a different cable 

for either camera? 


Roy T 


It’s somewhat of a coincidence with the timing of the 
two releases; however, you should be pleased to know 
that all versions of the Pi Camera Module (NoIR or 
normal, original or version 2) work on the Raspberry 
Pi Zero. Not only that, but the new cable works on all 
versions as well; you’|l need that cable to plug it into 
the Pi Zero, though. We’ve already seen some people 
upgrade the camera on their main Pi and use the old 
camera on their new Pi Zero. 
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Raspberry Pi 
Zero, as long 
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FROM THE FORUM: 


The Raspberry Pi Forum is a hotbed of 
conversations and problem-solving for the 


community - join in via raspberrypi.org/forums 


s anew boy of 88 years of age, who is endeavouring to 
repel the onslaught of galloping senility by swotting 
up on the Raspberry Pi, may I ask for some advice on 
which back issues would help me in my attempt at absorbing 
the necessary knowledge to move forward? 
atemunro 


Well, we have a few issues and books that have a beginner’s 
slant in some way. This very issue, in fact, has the beginner’s 
guide to electronics. Other issues that may interest you are 
issue 36 with our Getting Started with Raspberry Pi feature, 
our Pi Zero issue (issue 40) which will introduce you to the Pi 
Zero, and the camera issue from last month. All our Essentials 
books also start very simple and get more advanced, to teach 
you along the way, and there’s bound to be something to pique 


your interest in the Official Raspberry Pi Projects Book. They’re all 
available for free on our website: magpi.cc 
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Competition closes 27 June 2016. Prize is offered worldwide to participants aged 18 or over, except employees of the Raspberry Pi Foundation, the prize supplier, 
their families or friends. Winners will be notified by email after the draw date. By entering the competition, the winner consents to any publicity generated from the 
competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine (unless otherwise stated upon entry). We don't like 


spam. Participants’ details will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. 
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Column | THE FINAL WORD 


uite a few years ago, I once lined up early in 

the morning to buy a new smartphone on 

the day of its release. I’m not proud of that. 
In fact, I find myself cringing just thinking about 
it. At the time, I was closely following all the latest 
developments in technology and I had a severe case 
of consumer technolust. I almost always had to own 
the latest and greatest gadget, even if my wallet 
couldn’t quite accommodate my acquisitions. In the 
years that followed, I’ve cooled off quite a bit. I only 
rarely find myself pining for new consumer tech. 

Don’t get me wrong, I love all of the amazing 
advancements in consumer technology such 
as phones, tablets, laptops, wearables, and VR 
headsets. I don’t take for granted how far we’ve 
come in the last few years. For example, whenever 
I pull out my phone to search a map or send a photo 
to my friends, I think how lucky we are to have such 
powerful tools at our disposal. What’s changed is 
my interest in technology. I became more excited 
about how maker technology like Raspberry Pi can 
empower people to create the things they want 
instead of waiting for a large electronics company 
to make it for them. 

As an example, lately I’ve seen a lot of makers 
using Raspberry Pis to create ‘magic mirrors’, 
which are mirrors that can display information. 
These devices let you see news headlines as you 
primp in the morning. To create them, makers use 
a two-way mirror and mount a display behind it. 
The display is driven by a Raspberry Pi to show traffic 
conditions, weather, your agenda, the news, or 
anything else that you want. 

It’s quite possible that one day you’ll be able to 
find mass-produced consumer magic mirrors on 
retail store shelves. But maker technology like 
Raspberry Pi enables people to create it now instead 
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MATT RICHARDSON 


Matt is Raspberry Pi's US-based product evangelist. Before 
that, he was co-author of Getting Started with Raspberry Pi 
anda contributing editor at Make: magazine. 


, The power of maker technology helps cure Matt Richardson’s technolust 


of waiting for large electronics companies to make 
one for them. While they may not be easy enough 
for acomplete novice to set up, maker-made magic 
mirrors also have the benefit of being incredibly 
customisable and versatile. And instead of becoming 
completely obsolete, the parts can be repurposed 

for other projects when the time comes. 


Custom-made technology 

I’ve been finding many other examples of makers 
using Raspberry Pis to create the products that large 
companies don’t yet make widely available. Makers 
with diabetes have used technology to create their 
own closed-loop systems between their glucometer 
and their insulin pump in order to micromanage 
their blood glucose levels. Another maker recently 
used a pair of Raspberry Pi cameras on a robot to 
create a remote telepresence vehicle for virtual 
reality headsets. 

Instead of consumer products, my technolust is 
for now for maker products, but I don’t feel the same 
kind of guilt. Maker technology is versatile and can 
be used for so many more things than could even be 
imagined by the products’ creators. And since maker 
products can be used for so many possible things, 
they have a much longer shelf life. Even though 
we’ve made so many improvements to the Raspberry 
Pi in the last four years, there are still many original 
Raspberry Pi Model Bs out in the world earning their 
keep, and I suspect that they’ll be chugging away for 
years to come. 

Although consumer technology is empowering, | 
think there’s one key thing about maker technology 
like Raspberry Pi that’s worth getting really excited 
about: what people create with maker technology 
today will become the consumer technology 
of tomorrow. 
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The command- ake a look at that blinking cursor on your terminal, and what’s \ 
line ‘envi it 3 ‘ a . 
presents your cut-out-and-keep Bpesaalo behind it: pi@raspberrypi ~ $ ( ON UER 
. . . . ‘h VY 1 f 2 wae 
guide to using the command line on the Raspberry Pi. conchongeyeu F i sencilla aes ee ee i nee 
In part 5, we make Raspbian a little more personal as ri cl ma Sc geen eee aM 
p 5» p ; Pp : withoutachange —_ is /home/pi in this case. Before that is [user name]@[computer name], 4, 
we get it to behave and look just the way you want it... Soperdirgupen in the form pi@raspberrypi. Not only is this informative (at least if “aN 


what youneedto _you’ve forgotten who and where you are), but it’s something you can 
dotnanethertole change and personalise. | l | : | | 
New user 
Let’s start with that user name — pi. If more than one person in 
your family uses the Pi, you may want to keep the pi user for shared 
projects, but set up individual login accounts for family members, 
including yourself. Creating a new user in Raspbian is easy: sudo 
adduser jo...will create a new user account named jo. You will be 
prompted for a password (pick a good one) and lots of irrelevant info 
(dating back to shared university computers of the 1970s) that you can 
safely ignore by just pressing ENTER at each prompt. Now we have a 
user account for jo, have a look at /home/jo. Looks empty? Usels -A. 
Jo has never logged into the computer, so you will see the absence of 
most of the contents of /home/pi for now, such as ~/.gconf, but there 
is a .bashre and a couple of other config files. 


TERMINAL GUIDE 


Written by Richard Smedley | 
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serial P! Plus 


RS232 serial communication board. 
Control your Raspberry Pi over RS232 
or connect to external serial 
accessories. 


Breakout Fi Plus 


The Breakout Pi Plus is a useful 
and versatile prototyping expansion 
board for the Raspberry Pi 


ADC Differential P’ 


8 channel 18 bit analogue to digital 
converter. I?C address selection 
allows you to add up to 32 analogue 
inputs to your Raspberry Pi. 


IO Pi Plus 


32 digital 5V inputs or outputs. |?C 
address selection allows you to stack 
up to 4 IO Pi Plus boards on your 
Raspberry Pi giving you 128 digital 
inputs or outputs. 


RIC Pi Plus 


Real-time clock with battery backup 
and 5V I°C level converter for adding 
external 5V I?C devices to your 
Raspberry Pi. 


| Wire Pi Plus 


1-Wire® to I?C host interface with ESD 
protection diode and |?C address 
selection. 
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GoPiGo 


Everything you need to 
build a Raspberry Pi robot! 


Connect hundreds of sensors 
to your Raspberry Pi! 


